Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

TikTok API videoları, hashtag'leri ya da trendleri arayabilir mi?

Evet, TikTok API'si videoları, reklamları ve trendleri arayabilir; her biri ayrı bir API'de. Research API, TikTok'un onayladığı araştırmacılar için anahtar kelime, hashtag, kullanıcı adı, bölge veya tarihe göre herkese açık videoları arar. Commercial Content API reklamları anahtar kelime ya da reklamveren adıyla arar. API for Business, popüler hashtag'leri, bu hashtag'lerdeki trend videoları ve trend arama anahtar kelimelerini döndürür. Display API ise yetkilendirilmiş bir kullanıcının kendi profilini ve videolarını okur.

easyCoexistence, TikTok hesaplarını TikTok'un API for Business'ı üzerinden bağlar; böylece Claude, ChatGPT ya da kendi platformunuz hesabın gönderilerini ve yorumlarını listeler ve içgörülerini okur, get_social_credentials ise kendi kodunuza hashtag önerileri gibi business/ uç noktaları için token'ı verir; her bağlantı günün her saati izlenir.

1,000 a day

Research API'de günde izin verilen istek sayısı, 100.000 kayda kadar; kota 12 AM UTC'de sıfırlanır.

30 days

Tek bir Research API video sorgusunda start_date ile end_date arasındaki en uzun süre; istek başına en fazla 100 video döner.

Top 200

/discovery/trending_list/, bir ülke ve kategori için popüler hashtag'leri son 1, 7, 30 ya da 120 güne göre sıralar.

20

/discovery/trending/search/ uç noktasının döndürdüğü trend arama anahtar kelimeleri, Advanced Access ya da Verified Business Account sahibi hesaplar içindir.

50 characters

Commercial Content API'nin kabul ettiği en uzun search_term; varsayılan olarak tam ifade, ya da bulanık ifade olarak eşleşir.

Hangi TikTok API'ler arama yapabilir?

Birden fazlası var; iki geliştirici portalında bulunur ve her biri farklı bir geliştirici türü için tasarlanmıştır. developers.tiktok.com üzerinde Research API, Commercial Content API ve Display API yer alır; business-api.tiktok.com üzerinde ise API for Business bulunur. Bu API'nin Discovery, Accounts ve Mentions uç noktaları trendleri ve bir işletmenin kendi içeriğini kapsar:

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

Research API videoları nasıl arar?

POST https://open.tiktokapis.com/v2/research/video/query/ adresine, research.data.basic kapsamına sahip bir istemci erişim token'ıyla istek gönderilir. Sorgu nesnesi and, or ve not koşullarını birleştirir; her biri keyword, hashtag_name, username, region_code, create_date ya da video_length gibi bir alanda EQ ya da IN gibi bir işlemdir. YYYYMMDD biçiminde yazılan start_date ve end_date en fazla 30 gün ara olabilir; max_count ise istek başına en fazla 100 video döndürür:

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"
  }'

Research API ne döndürür ve veriler ne kadar güncel?

fields parametresinde belirtilen herkese açık video alanları; örneğin id, video_description, create_time, region_code, view_count, like_count, comment_count, share_count, hashtag_names ve username. TikTok'un SSS'si, görüntülenme ve takipçi sayısı gibi istatistiklerin güncellenmesinin 10 güne kadar sürebileceğini, yeni videoların arama sonuçlarında görünmesinin ise 48 saate kadar sürebileceğini belirtir. Günlük kota 1.000 istektir ve Research API'leri genelinde en fazla 100.000 kayda kadar sayılır; 12 AM UTC'de sıfırlanır.

Research API'yi kimler kullanabilir?

Projesi TikTok tarafından onaylanan araştırmacılar; yalnızca geliştirici hesabı sahibi olmak erişim sağlamaz. TikTok, ABD, EEA, Birleşik Krallık, Kanada veya İsviçre'deki akademik kurumları; AB'deki kâr amacı gütmeyen ya da bağımsız araştırma kuruluşlarını ve Brezilya'da çevrimiçi gençlik güvenliğini inceleyen akademik ya da kâr amacı gütmeyen kuruluşları listeler. Başvuru sahipleri ticari çıkarlardan bağımsız çalışır, tanımlı bir araştırma önerisi, açıklanmış finansman ve etik inceleme sunar; TikTok genellikle 4 hafta içinde yanıt verir. İçerik üreticilerinin, reklamverenlerin ve ticari kullanıcıların uygun olup olmadığı sorulduğunda, SSS'si hayır yanıtını verir.

Commercial Content API ile reklamları nasıl ararsınız?

POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ adresine ve research.adlib.basic kapsamıyla istek gönderilerek. search_term en fazla 50 karakter alır; varsayılan olarak exact_phrase biçiminde eşleşir ya da fuzzy_phrase ile, bu da sözcüklerinin herhangi birini ya da hepsini herhangi bir sırada bulur. Filtreler sonuçları yayın tarihlerine ve hedef ülkelere göre daraltır; her çağrı en fazla 10 reklam döndürür. TikTok'un ürün sayfasına göre veriler AB'deki reklamlarla başlar ve bir reklam en son gösterildikten bir yıl sonrasına kadar erişilebilir kalır. Her ülkeden herkese açık kişiler ve araştırmacılar çevrimiçi bir form üzerinden başvurabilir; TikTok 2 iş günü içinde yanıtlamayı hedefler.

API for Business hangi trendleri döndürür?

Discovery uç noktalarının döndürdüğü trendler; bunlar aldıkları token'a göre farklılık gösterir. /discovery/trending_list/, bir ülke için (varsayılan olarak ABD) ve bir sektör kategorisi için son 1, 7, 30 ya da 120 günde en fazla 200 popüler hashtag'i sıralar; her hashtag'in sırasını, görüntülenmesini ve gönderi sayısını da verir. /discovery/video_list/ ise bu hashtag'lerin en fazla 10 tanesi için en çok trend olan 20 videoyu döndürür. İkisi de advertiser_id ve bir reklamverenin erişim token'ını alır. Ayrıca discovery.search.words kapsamıyla bir TikTok hesabının token'ını alan iki uç nokta daha vardır; bunlar Advanced Access ya da Verified Business Account'a sahip hesaplar içindir:

  • /discovery/trending/search/: TikTok'ta trend olan 20 arama anahtar kelimesi; is_personalized ile hesaba göre kişiselleştirilebilir.
  • /discovery/trending/search/keyword/: Bir ürün ya da marka gibi en fazla 255 karakterlik bir sorgu için önerilen 20 arama anahtar kelimesi.

Bir TikTok hesabının kendi API'si neleri arayabilir?

Açıklamalarındaki hashtag'ler ve marka hashtag'lerini taşıyan gönderiler. GET /business/hashtag/suggestion/ bir anahtar kelime ve isteğe bağlı bir dil alır; önce tam eşleşmeye, sonra gönderi sayısına göre sıralanmış 10 hashtag döndürür, her birinin post_count alanıyla birlikte. Mentions uç noktası /business/mention/hashtag/video/list/, işletmenin etkinleştirdiği marka hashtag'lerinden birini kullanan, son 90 güne ait en fazla 1.000 herkese açık gönderiyi döndürür; bunlardan en fazla 50 tanesi zamana, beğenilere, yorumlara ya da paylaşımlara göre sıralanır. biz.brand.insights kapsamını ve Advanced Access ya da Verified Business Account'a sahip bir hesabı gerektirir.

Display API arama yapabilir mi?

Hayır. Uygulamayı yetkilendiren kullanıcıyı okur: /v2/user/info/ o kullanıcının profilini, /v2/video/list/ herkese açık videolarını en yeniden eskiye doğru ve sayfa başına en fazla 20 tane olacak şekilde, /v2/video/query/ ise belirli videoları ID'lerine göre döndürür; user.info.basic ve video.list kapsamları altında. Uç noktalarının hiçbiri anahtar kelime ya da hashtag almaz.

easyCoexistence TikTok'ta neleri arayabilir?

Bağlı hesabın kendi API'sinin yanıtladıkları. list_social_posts bağlı hesabın son gönderilerini, list_social_comments ise bir gönderinin yorumlarını listeler; kendi kodunuz ise get_social_credentials'tan aldığı token ile business/ altındaki API for Business yollarını çağırır, hashtag önerileri de dahildir. /discovery/ yolları bir reklamverenin token'ını aldığı için hesabın token'ı bunlara ulaşamaz; Research ve Commercial Content API'leri ise kendi başvurularıyla ayrı developers.tiktok.com ürünleridir.

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>

Yaygın hatalar

  • Bir markayı takip etmek için Research API'ye başvurmak. TikTok'un SSS'si içerik üreticilerine, reklamverenlere ve ticari kullanıcılara hayır yanıtı verir; yalnızca ticari olmayan araştırma projelerini onaylar.
  • Research API'de tek bir çağrıyla uzun bir dönemi sorgulamak. end_date, start_date'ten en fazla 30 gün sonra olabilir; daha uzun dönemleri aralıklara bölün.
  • Hashtag önerilerini trend olarak okumak. /business/hashtag/suggestion/ tam eşleşmeye ve gönderi sayısına göre sıralar; /discovery/trending_list/ ise seçilen bir dönemde popülerliğe göre sıralar.
  • Kişisel bir hesap için trend arama uç noktalarını çağırmak. Bunlar, token üzerinde discovery.search.words bulunan Advanced Access ya da Verified Business Account sahipleri için yanıt verir.
Bunu EasyCoexistence'la yapmak

Bağlantı başına aylık US$ 9'dan US$ 0.75'e kadar; bağlantı sayısı arttıkça fiyat düşer ve ilk 3 gün ücretsiz deneme sunulur.

Sık sorulan sorular

TikTok videolarını API ile anahtar kelimeye göre arayabilir miyim?

Evet, TikTok araştırma projenizi onayladıktan sonra Research API ile. Video sorgusu, herkese açık videolar üzerinde keyword ve hashtag_name koşullarını kabul eder; istek başına en fazla 100 video döner.

TikTok'ta trend hashtag'ler için bir API var mı?

Evet. API for Business üzerindeki /discovery/trending_list/, bir ülke ve kategori için en fazla 200 popüler hashtag'i, her birinin görüntülenme ve gönderi sayısıyla birlikte sıralar; bir reklamverenin token'ı gerekir.

TikTok'ta trend videolar için bir API var mı?

Evet. API for Business üzerindeki /discovery/video_list/, en fazla 10 popüler hashtag için en çok trend olan 20 videoyu döndürür; bir advertiser_id ve bir reklamverenin erişim token'ı gerekir.

TikTok API'si hesabımdan bahseden yorumları bulabilir mi?

Evet, Advanced Access ya da Verified Business Account sahipleri için: Mentions API'nin /business/mention/comment/list/ uç noktası, hesabı @ ile etiketleyen en fazla 1.000 yorum ya da yanıtı döndürür; biz.brand.insights ve comment.list kapsamları altında.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi