MasukMulai uji coba gratis
easyCoexistence API resmi

Apakah API TikTok bisa mencari video, hashtag, atau tren?

Ya, API TikTok bisa mencari video, iklan, dan tren, masing-masing lewat API terpisah: Research API mencari video publik berdasarkan kata kunci, hashtag, nama pengguna, wilayah, atau tanggal, untuk peneliti yang disetujui TikTok. Commercial Content API mencari iklan berdasarkan kata kunci atau nama pengiklan. API for Business mengembalikan hashtag populer, video yang sedang tren, dan kata kunci pencarian yang sedang tren. Display API membaca profil dan video milik pengguna yang memberi otorisasi.

easyCoexistence menghubungkan akun TikTok lewat API for Business milik TikTok, sehingga Claude, ChatGPT, atau platform Anda sendiri dapat menampilkan unggahan dan komentar akun serta membaca insight-nya, dan get_social_credentials memberi kode Anda sendiri token untuk endpoint business/ seperti saran hashtag, dengan setiap koneksi dipantau sepanjang waktu.

1,000 a day

Kuota permintaan Research API per hari, untuk hingga 100,000 rekaman, dengan kuota diatur ulang pukul 12 AM UTC.

30 days

Rentang terpanjang antara start_date dan end_date dalam satu kueri video Research API, yang mengembalikan hingga 100 video per permintaan.

Top 200

Hashtag populer /discovery/trending_list/ memberi peringkat untuk satu negara dan kategori selama 1, 7, 30, atau 120 hari terakhir.

20

Kata kunci pencarian tren /discovery/trending/search/ dikembalikan untuk akun dengan Advanced Access atau Verified Business Account.

50 characters

Panjang search_term maksimum yang diterima Commercial Content API, dicocokkan sebagai frasa persis secara default atau sebagai frasa fuzzy.

API TikTok mana yang bisa melakukan pencarian?

Beberapa, di dua portal developer, masing-masing untuk jenis developer yang berbeda. developers.tiktok.com menampung Research API, Commercial Content API, dan Display API; business-api.tiktok.com menampung API for Business, yang endpoint Discovery, Accounts, dan Mentions-nya mencakup tren serta konten bisnis sendiri:

Research APIPublic videos by keyword, hashtag, username, region or date; approved researchers
Commercial Content APIAds by keyword or advertiser name, starting with ads data from the EU
Discovery endpointsPopular hashtags, their trending videos, and trending search keywords
Mentions endpointsUp to 1,000 recent public posts carrying the business's brand hashtags
Hashtag suggestion10 hashtags for a keyword, for the authorized account's captions
Display APINo search: an authorized user's profile and public videos

Bagaimana Research API mencari video?

Dengan POST https://open.tiktokapis.com/v2/research/video/query/ dan client access token yang memiliki scope research.data.basic. Objek query menggabungkan kondisi and, or, dan not, masing-masing berupa operasi seperti EQ atau IN pada field seperti keyword, hashtag_name, username, region_code, create_date, atau video_length. start_date dan end_date, ditulis YYYYMMDD, boleh berjarak paling jauh 30 hari, dan max_count mengembalikan hingga 100 video per permintaan:

A Research API video query, after TikTok's own example
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"
  }'

Apa yang dikembalikan Research API, dan seberapa baru datanya?

Field video publik yang disebut dalam fields, seperti id, video_description, create_time, region_code, view_count, like_count, comment_count, share_count, hashtag_names, dan username. FAQ TikTok memperingatkan bahwa statistik seperti jumlah tayangan dan pengikut bisa butuh hingga 10 hari untuk diperbarui, dan video baru bisa butuh hingga 48 jam untuk muncul di pencarian. Kuota harian adalah 1,000 permintaan, hingga 100,000 rekaman di seluruh research API, diatur ulang pukul 12 AM UTC.

Siapa yang bisa menggunakan Research API?

Peneliti yang proyeknya disetujui TikTok; akun developer saja tidak memberi akses. TikTok mencantumkan institusi akademik di AS, EEA, Inggris, Kanada, atau Swiss, badan riset nirlaba atau independen di UE, serta organisasi akademik atau nirlaba di Brasil yang meneliti keselamatan remaja daring. Pemohon bekerja independen dari kepentingan komersial, dengan proposal riset yang jelas, pendanaan yang diungkap, dan tinjauan etika, dan TikTok biasanya menjawab dalam 4 minggu. Ketika ditanya apakah kreator, pengiklan, dan pengguna komersial memenuhi syarat, FAQ-nya menjawab tidak.

Bagaimana cara mencari iklan dengan Commercial Content API?

Dengan POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ dan scope research.adlib.basic. search_term menerima hingga 50 karakter, dicocokkan sebagai exact_phrase secara default atau sebagai fuzzy_phrase, yang menemukan salah satu atau semua katanya dalam urutan apa pun; filter mempersempit hasil berdasarkan tanggal tayang dan negara target, dan setiap panggilan mengembalikan paling banyak 10 iklan. Halaman produk TikTok menyatakan data dimulai dari iklan di UE dan tetap tersedia hingga satu tahun setelah iklan terakhir tayang. Publik dan peneliti di negara mana pun bisa mengajukan lewat formulir daring, dan TikTok berencana menjawab dalam 2 hari kerja.

Tren apa yang dikembalikan API for Business?

Tren dari endpoint Discovery-nya, yang berbeda menurut token yang dipakai. /discovery/trending_list/ memberi peringkat hingga 200 hashtag populer untuk satu negara, AS secara default, dan kategori industri, selama 1, 7, 30, atau 120 hari, dengan peringkat, tayangan, dan unggahan tiap hashtag. /discovery/video_list/ mengembalikan 20 video tren teratas untuk hingga 10 hashtag tersebut; keduanya memerlukan advertiser_id dan access token pengiklan. Dua lagi memakai token akun TikTok dengan scope discovery.search.words, untuk akun dengan Advanced Access atau Verified Business Account:

  • /discovery/trending/search/: 20 kata kunci pencarian yang sedang tren di TikTok, atau dipersonalisasi untuk akun dengan is_personalized.
  • /discovery/trending/search/keyword/: 20 kata kunci pencarian yang direkomendasikan untuk kueri hingga 255 karakter, seperti produk atau merek.

Apa yang bisa dicari API milik akun TikTok sendiri?

Hashtag untuk keterangannya, dan unggahan yang memuat hashtag merek. GET /business/hashtag/suggestion/ menerima kata kunci dan bahasa opsional, lalu mengembalikan 10 hashtag, diurutkan berdasarkan kecocokan persis lalu jumlah unggahan, masing-masing dengan post_count-nya. Endpoint Mentions /business/mention/hashtag/video/list/ mengembalikan hingga 1,000 unggahan publik dari 90 hari terakhir yang memakai salah satu hashtag merek yang diaktifkan bisnis, hingga 50 di antaranya, diurutkan berdasarkan waktu, suka, komentar, atau bagikan. Endpoint ini memerlukan scope biz.brand.insights dan akun dengan Advanced Access atau Verified Business Account.

Bisakah Display API melakukan pencarian?

Tidak. API ini membaca pengguna yang memberi otorisasi kepada aplikasi: /v2/user/info/ mengembalikan profil pengguna tersebut, /v2/video/list/ video publiknya, terbaru lebih dulu dan hingga 20 per halaman, dan /v2/video/query/ video tertentu berdasarkan ID, di bawah scope user.info.basic dan video.list. Tidak ada endpoint-nya yang menerima kata kunci atau hashtag.

Apa yang bisa dicari easyCoexistence di TikTok?

Apa yang dijawab API akun terhubung itu sendiri. list_social_posts menampilkan unggahan terbaru akun dan list_social_comments menampilkan komentar sebuah unggahan, sementara kode Anda sendiri memanggil path API for Business di bawah business/ dengan token dari get_social_credentials, termasuk saran hashtag. Path /discovery/ membutuhkan token pengiklan, sehingga token akun tidak menjangkaunya, dan Research API serta Commercial Content API adalah produk developers.tiktok.com yang terpisah dengan aplikasinya sendiri.

Hashtag suggestions from your own code
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>

Kesalahan umum

  • Mengajukan Research API untuk melacak merek. FAQ TikTok menjawab tidak untuk kreator, pengiklan, dan pengguna komersial, serta hanya menyetujui proyek riset nonkomersial.
  • Mengkueri periode panjang dalam satu panggilan Research API. end_date boleh paling jauh 30 hari setelah start_date, jadi pecah periode yang lebih panjang menjadi beberapa jendela.
  • Membaca saran hashtag sebagai tren. /business/hashtag/suggestion/ mengurutkan berdasarkan kecocokan persis dan jumlah unggahan, sedangkan /discovery/trending_list/ memberi peringkat popularitas dalam periode yang dipilih.
  • Memanggil endpoint pencarian tren untuk akun pribadi. Endpoint ini menjawab untuk akun dengan Advanced Access atau Verified Business Account, dengan discovery.search.words pada token.
Melakukan ini dengan EasyCoexistence

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Bisakah saya mencari video TikTok berdasarkan kata kunci lewat API?

Bisa dengan Research API, setelah TikTok menyetujui proyek riset Anda: kueri videonya menerima kondisi keyword dan hashtag_name atas video publik, hingga 100 per permintaan.

Apakah ada API TikTok untuk hashtag yang sedang tren?

Ada. /discovery/trending_list/ pada API for Business memberi peringkat hingga 200 hashtag populer untuk satu negara dan kategori, masing-masing dengan tayangan dan unggahannya, untuk token pengiklan.

Apakah ada API TikTok untuk video yang sedang tren?

Ada. /discovery/video_list/ pada API for Business mengembalikan 20 video tren teratas untuk hingga 10 hashtag populer, dengan advertiser_id dan access token pengiklan.

Bisakah API TikTok menemukan komentar yang menyebut akun saya?

Bisa, untuk akun dengan Advanced Access atau Verified Business Account: /business/mention/comment/list/ pada Mentions API mengembalikan hingga 1,000 komentar atau balasan yang @mention akun tersebut, di bawah scope biz.brand.insights dan comment.list.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada