Czy API TikTok może wyszukiwać filmy, hashtagi i trendy?
Tak, API TikTok może wyszukiwać filmy, reklamy i trendy, każde w osobnym API: Research API przeszukuje publiczne filmy według słowa kluczowego, hashtagu, nazwy użytkownika, regionu lub daty, dla badaczy zatwierdzonych przez TikTok. Commercial Content API wyszukuje reklamy według słowa kluczowego lub nazwy reklamodawcy. API for Business zwraca popularne hashtagi, filmy w trendach dla tych hashtagów i popularne frazy wyszukiwania. Display API odczytuje profil i filmy autoryzowanego użytkownika.
easyCoexistence podłącza konta TikTok przez API for Business, więc Claude, ChatGPT lub własna platforma wyświetla posty i komentarze konta i odczytuje jego statystyki, a get_social_credentials daje własnemu kodowi token do ścieżek business/, np.
Dzienne limity żądań Research API: do 100 000 rekordów, a limit resetuje się o północy UTC.
Najdłuższy odstęp między start_date a end_date w jednym zapytaniu wideo Research API, które zwraca do 100 filmów na żądanie.
Popularne hashtagi, które /discovery/trending_list/ zestawia w ranking dla kraju i kategorii z ostatnich 1, 7, 30 lub 120 dni.
Popularne frazy wyszukiwania: /discovery/trending/search/ zwraca je dla kont z Advanced Access lub Verified Business Account.
Najdłuższe search_term, jakie przyjmuje Commercial Content API, dopasowywane jako fraza dokładna domyślnie albo jako fraza rozmyta.
Które API TikTok może wyszukiwać?
Kilka, na dwóch portalach deweloperskich, z których każdy jest przeznaczony dla innego typu dewelopera. developers.tiktok.com udostępnia Research API, Commercial Content API i Display API; business-api.tiktok.com udostępnia API for Business, którego endpointy Discovery, Accounts i Mentions obejmują trendy oraz treści własne firmy:
Jak Research API wyszukuje filmy?
Za pomocą POST https://open.tiktokapis.com/v2/research/video/query/ i tokenu dostępu klienta z zakresem research.data.basic. Obiekt query łączy warunki and, or i not; każdy to operacja, np. EQ lub IN, na polu, np. keyword, hashtag_name, username, region_code, create_date lub video_length. start_date i end_date, zapisane jako YYYYMMDD, mogą być oddalone od siebie najwyżej o 30 dni, a max_count zwraca do 100 filmów na żądanie:
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
-H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"and": [
{ "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
{ "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
],
"not": [
{ "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
]
},
"max_count": 100,
"start_date": "20261001",
"end_date": "20261030"
}'Co zwraca Research API i jak świeże są dane?
Pola publicznych filmów wymienione w fields, np. id, video_description, create_time, region_code, view_count, like_count, comment_count, share_count, hashtag_names i username. FAQ TikTok ostrzega, że statystyki, takie jak liczba wyświetleń i obserwujących, mogą aktualizować się nawet 10 dni, a nowe filmy mogą pojawiać się w wyszukiwaniu po nawet 48 godzinach. Dzienny limit to 1 000 żądań i do 100 000 rekordów w sumie we wszystkich research API, a resetuje się o północy UTC.
Kto może korzystać z Research API?
Badacze, których projekt zatwierdza TikTok; samo konto dewelopera nie daje dostępu. TikTok wymienia instytucje akademickie w USA, EOG, Wielkiej Brytanii, Kanadzie lub Szwajcarii, niezależne lub non-profit ośrodki badawcze w UE oraz organizacje akademickie lub non-profit w Brazylii, badające bezpieczeństwo młodych użytkowników sieci. Wnioskodawcy działają niezależnie od interesów komercyjnych, mają zdefiniowaną propozycję badania, ujawnione finansowanie i ocenę etyczną, a TikTok zwykle odpowiada w ciągu 4 tygodni. Na pytanie, czy twórcy, reklamodawcy i użytkownicy komercyjni się kwalifikują, FAQ odpowiada przecząco.
Jak wyszukiwać reklamy przez Commercial Content API?
Za pomocą POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ i zakresu research.adlib.basic. search_term przyjmuje do 50 znaków, dopasowywanych jako exact_phrase domyślnie lub jako fuzzy_phrase, który znajduje dowolne lub wszystkie swoje słowa w dowolnej kolejności; filtry zawężają wyniki według dat publikacji i krajów docelowych, a każde wywołanie zwraca najwyżej 10 reklam. Strona produktu TikTok mówi, że dane zaczynają się od reklam z UE i pozostają dostępne do roku po ostatnim wyświetleniu reklamy. Każdy z dowolnego kraju, także osoby prywatne i badacze, może złożyć wniosek przez formularz online, a TikTok spodziewa się odpowiedzi w ciągu 2 dni roboczych.
Jakie trendy zwraca API for Business?
Te z jego endpointów Discovery, które różnią się tokenem, którego wymagają. /discovery/trending_list/ tworzy ranking do 200 popularnych hashtagów dla kraju (domyślnie USA) i kategorii branżowej z 1, 7, 30 lub 120 dni, z pozycją w rankingu, liczbą wyświetleń i postów każdego hashtagu, a /discovery/video_list/ zwraca 20 najpopularniejszych filmów w trendach dla do 10 z tych hashtagów; oba przyjmują advertiser_id i token dostępu reklamodawcy. Dwa kolejne przyjmują token konta TikTok z zakresem discovery.search.words, dla kont z Advanced Access lub Verified Business Account:
- /discovery/trending/search/: 20 fraz wyszukiwania będących w trendzie na TikToku albo spersonalizowanych dla konta, z
is_personalized. - /discovery/trending/search/keyword/: 20 rekomendowanych fraz wyszukiwania dla zapytania do 255 znaków, np. nazwy produktu lub marki.
Co może wyszukiwać własne API konta TikTok?
Hashtagi do podpisów pod postami oraz posty z hashtagami marki konta. GET /business/hashtag/suggestion/ przyjmuje słowo kluczowe i opcjonalny język, a zwraca 10 hashtagów, uporządkowanych najpierw wg dokładnego dopasowania, a potem wg liczby postów, każdy z post_count. Endpoint Mentions /business/mention/hashtag/video/list/ zwraca do 1 000 publicznych postów z ostatnich 90 dni, które używają jednego z włączonych przez firmę hashtagów marki, do 50 z nich, sortowanych wg czasu, polubień, komentarzy lub udostępnień. Wymaga zakresu biz.brand.insights oraz konta z Advanced Access lub Verified Business Account.
Czy Display API może wyszukiwać?
Nie. Odczytuje użytkownika, który autoryzował aplikację: /v2/user/info/ zwraca profil tego użytkownika, /v2/video/list/ jego publiczne filmy, od najnowszych, po 20 na stronę, a /v2/video/query/ wybrane filmy po ID, w ramach zakresów user.info.basic i video.list. Żaden z jego endpointów nie przyjmuje słowa kluczowego ani hashtagu.
Co easyCoexistence może wyszukać na TikToku?
To, na co odpowiada własne API podłączonego konta. list_social_posts wyświetla ostatnie posty konta, a list_social_comments komentarze pod postem, natomiast Twój własny kod wywołuje ścieżki API for Business w business/ z tokenem z get_social_credentials, łącznie z podpowiedziami hashtagów. Ścieżki /discovery/ wymagają tokenu reklamodawcy, więc token konta do nich nie sięga, a Research API i Commercial Content API to osobne produkty developers.tiktok.com, każdy z własnymi procesami zgłoszeń.
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>Typowe błędy
- Składanie wniosku o Research API, by śledzić markę. FAQ TikTok odpowiada przecząco twórcom, reklamodawcom i użytkownikom komercyjnym, a zatwierdza niekomercyjne projekty badawcze.
- Zapytanie o długi okres w jednym wywołaniu Research API. end_date może być oddalone od start_date najwyżej o 30 dni, więc dłuższe okresy dziel na okna.
- Traktowanie podpowiedzi hashtagów jako trendów. /business/hashtag/suggestion/ porządkuje wg dokładnego dopasowania i liczby postów, a /discovery/trending_list/ ustala ranking popularności w wybranym okresie.
- Wywoływanie endpointów trendów wyszukiwania dla konta osobistego. Odpowiadają one kontom z Advanced Access lub Verified Business Account, a token musi mieć discovery.search.words.
podpowiedzi hashtagów; każde połączenie jest monitorowane całą dobę. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, z każdym kolejnym połączeniem taniej, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Czy mogę wyszukiwać filmy TikTok po słowie kluczowym przez API?
Tak, przez Research API, po zatwierdzeniu projektu badawczego przez TikTok: jego zapytanie wideo przyjmuje warunki keyword i hashtag_name dla publicznych filmów, do 100 na żądanie.
Czy istnieje API TikTok dla popularnych hashtagów?
Tak. /discovery/trending_list/ w API for Business tworzy ranking do 200 popularnych hashtagów dla kraju i kategorii, każdy z wyświetleniami i postami, dla tokenu reklamodawcy.
Czy istnieje API TikTok dla filmów w trendach?
Tak. /discovery/video_list/ w API for Business zwraca 20 najpopularniejszych filmów w trendach dla do 10 popularnych hashtagów, z advertiser_id i tokenem dostępu reklamodawcy.
Czy API TikTok może znaleźć komentarze wspominające moje konto?
Tak, dla kont z Advanced Access lub Verified Business Account: /business/mention/comment/list/ w Mentions API zwraca do 1 000 komentarzy lub odpowiedzi, które wspominają konto przez @, w ramach zakresów biz.brand.insights i comment.list.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w