লগ ইনফ্রি ট্রায়াল শুরু করুন
easyCoexistence অফিসিয়াল API

API দিয়ে TikTok অ্যাকাউন্টের ভিডিও তালিকাভুক্ত করা

TikTok-এর API for Business GET /business/video/list/ দিয়ে কোনো অ্যাকাউন্টের পাবলিক পোস্ট তালিকাভুক্ত করে, সর্বশেষটি থেকে শুরু করে, প্রতি পেজে সর্বোচ্চ 20টি। যে ফিল্ডগুলো ফেরত চান তা নাম দিয়ে উল্লেখ করুন, যেমন item_id, caption, share_url এবং video_views, আর has_more সত্য থাকা পর্যন্ত cursor দিয়ে পরের পেজগুলো দেখুন। filters.video_ids নির্দিষ্ট কিছু পোস্ট বেছে নেয়, এবং প্রতিটি item_id হলো সেই ID, যা কমেন্ট কলগুলো নেয়।

easyCoexistence Claude, ChatGPT বা আপনার নিজের কোড থেকে list_social_posts দিয়ে একটি TikTok অ্যাকাউন্টের সাম্প্রতিক পোস্ট তালিকাভুক্ত করে, প্রতিটি পোস্টের item_id, ক্যাপশন, লিংক ও সংখ্যাসহ, এবং পরের পেজ ও অন্যান্য ফিল্ডের জন্য get_social_credentials আপনার নিজের কোডকে টোকেন দেয়।

20

/business/video/list/ প্রতি পেজে সবচেয়ে বেশি যত পোস্ট ফেরত দেয়; max_count-এর ডিফল্ট 10।

Milliseconds

কার্সরের একক হলো UTC Unix টাইমস্ট্যাম্প; এন্ডপয়েন্ট সেটির আগে প্রকাশিত পোস্ট ফেরত দেয়।

item_id

ডিফল্ট ফিল্ড, যা একাধিক ফিল্ডের নাম নেওয়া অনুরোধে অবশ্যই থাকতে হবে, নইলে ত্রুটি দেখা দিতে পারে।

40/min

প্রতিটি অনুমোদিত অ্যাকাউন্টের জন্য এই এন্ডপয়েন্টে অনুমোদিত কলের সংখ্যা, যেমন Accounts API-র প্রতিটি এন্ডপয়েন্টে।

এন্ডপয়েন্ট কী ফেরত দেয়?

অ্যাকাউন্টের পাবলিক পোস্ট: প্রোফাইলে দেখানো ভিডিও, ফটো ও টেক্সট পোস্ট, এবং “Only show in ads” ভিডিও, যেগুলো প্রোফাইলে না দেখিয়ে বিজ্ঞাপন হিসেবে চলে। media_type VIDEO এবং PHOTO আলাদা করে দেখায়, যেখানে PHOTO ফটো ও টেক্সট পোস্ট দুটোই বোঝায়। সঙ্গীতের কপিরাইটের মতো লঙ্ঘনের কারণে TikTok যে পোস্ট ফিল্টার করে দিয়েছে, সেগুলো তালিকা থেকে বাদ যায়।

কীভাবে কল করবেন?

GET অনুরোধ ও URL প্যারামিটার দিয়ে: business_id, JSON অ্যারে আকারে fields, এবং ঐচ্ছিকভাবে filters, cursor ও max_count, যার ডিফল্ট 10। টোকেন যায় Access-Token হেডারে, আর ডেভেলপার অ্যাপের TikTok Accounts-এর অধীনে Get Account Media পারমিশন লাগে:

List the latest posts
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["item_id","create_time","media_type","caption","share_url","thumbnail_url","video_views","likes","comments","shares"]' \
  --data-urlencode 'max_count=20'

কোন ফিল্ড পোস্টকে বর্ণনা করে?

মেট্রিকের বাইরে, যা video_views থেকে impression_sources পর্যন্ত চলে, তালিকায় আরও থাকে এগুলো, সবই video.list স্কোপের অধীনে:

  • item_id: পোস্টের ID, যা কমেন্ট কল এবং filters.video_ids দ্বারা ব্যবহৃত হয়।
  • media_type: VIDEO, অথবা ফটো বা টেক্সট পোস্টের জন্য PHOTO।
  • is_ad: পোস্টটি বিজ্ঞাপনে ব্যবহৃত হচ্ছে কি না।
  • create_time: পোস্ট প্রকাশের সময়, UTC-তে Unix সেকেন্ডে।
  • caption: পোস্টের বর্ণনা, হ্যাশট্যাগসহ।
  • share_url: শেয়ার করা যায় এমন লিংক, যা মোবাইল ও ডেস্কটপে আলাদা আচরণ করে।
  • embed_url: অন্য সাইটে চালানোর প্লেয়ার লিংক, যা Friends বা Only you সেট করা পোস্ট চালায় না।
  • thumbnail_url: একটি অস্থায়ী প্রিভিউ ছবি, যার মেয়াদ x-expires প্যারামিটারে থাকে।
  • video_duration: সেকেন্ডে দৈর্ঘ্য, তিন দশমিক স্থান পর্যন্ত।

ফলাফলের একটি পেজ কেমন দেখায়?

TikTok যে ক্রমে ফেরত দেয় সেই ক্রমে একটি videos অ্যারে, সঙ্গে পরের পেজের জন্য পাঠানোর মান cursor, এবং has_more, যা বলে আরও একটি পেজ আছে কি না। create_time আসে Unix সেকেন্ডের স্ট্রিং হিসেবে। TikTok-এর উদাহরণটি বর্ণনামূলক ফিল্ড ও সংখ্যায় ছোট করা:

A page from /business/video/list/
{
  "code": 0,
  "message": "OK",
  "request_id": "2021080307532501024502410704A7306F",
  "data": {
    "videos": [
      {
        "item_id": "6990565363377392901",
        "create_time": "1627617835",
        "caption": "little coco",
        "share_url": "https://www.tiktok.com/@feather_in_the_w1nd/video/6990565363377392901?utm_campaign=tt4d_open_api&utm_source=6979330045630218242",
        "likes": 10,
        "comments": 2,
        "shares": 0,
        "video_views": 1231
      }
    ],
    "cursor": 0,
    "has_more": false
  }
}

পেজিনেশন কীভাবে কাজ করে?

সময় দিয়ে। cursor-এর ডিফল্ট বর্তমান মুহূর্ত, মিলিসেকেন্ডে, তাই প্রথম পেজে থাকে সবচেয়ে নতুন পোস্ট, এবং প্রতিটি প্রতিক্রিয়া পরের অনুরোধের জন্য cursor ফেরত দেয়। has_more যতক্ষণ সত্য থাকে, সেটি পাঠান। একটি কাস্টম টাইমস্ট্যাম্প সেই মুহূর্তের আগে প্রকাশিত পোস্ট তালিকাভুক্ত করে, আর TikTok-এর ট্রাস্ট ও সেফটি নিয়মের কারণে আরও পোস্ট বাকি থাকলেও পেজ max_count-এর চেয়ে ছোট হতে পারে।

Every page, in Python
import json, requests

API = "https://business-api.tiktok.com/open_api/v1.3"

def all_posts(token: str, business_id: str, fields: list[str]):
    params = {"business_id": business_id, "fields": json.dumps(fields), "max_count": 20}
    while True:
        r = requests.get(f"{API}/business/video/list/", headers={"Access-Token": token},
                         params=params, timeout=30).json()
        if r["code"] != 0:
            raise RuntimeError(f"{r['code']}: {r['message']}")
        yield from r["data"].get("videos", [])
        if not r["data"].get("has_more"):
            return
        params["cursor"] = r["data"]["cursor"]

নির্দিষ্ট পোস্ট কীভাবে আনবেন?

filters দিয়ে, একটি JSON অবজেক্ট: video_ids ফেরত দেওয়ার জন্য পোস্ট ID-এর তালিকা দেয়, যেমন পাবলিশিং স্ট্যাটাসের post_ids। ad_post_only, যা শুধু video_ids-এর পাশে বৈধ, শুধু Spark Ads-এর জন্য বিজ্ঞাপনদাতাদের অনুমোদিত পোস্ট রাখে। ফিল্টার করা অনুরোধ অন্য যেকোনো অনুরোধের মতোই ফিল্ড নেয়, তাই একটি কলেই কয়েকটি জানা পোস্টের সর্বশেষ সংখ্যা আনা যায়।

The filters parameter
filters={"video_ids":["6995316737801538821","8015388216995316737"]}

কোন সীমা প্রযোজ্য?

Accounts API প্রতি অনুমোদিত অ্যাকাউন্টের জন্য এই এন্ডপয়েন্টে প্রতি মিনিটে 40টি কল অনুমোদন করে, এবং একটি অ্যাপের Accounts API কলগুলো মিলে Basic স্তরে প্রতি মিনিটে 600টি এবং তার উপরে 1,000টি পায়। বর্ণনামূলক ফিল্ড রিয়েল টাইমে আসে, সংখ্যা সাধারণত 24 থেকে 48 ঘণ্টা পিছিয়ে থাকে, এবং পোস্ট প্রকাশের 365 দিন পর তার ডেটা আর আপডেট হয় না।

easyCoexistence কীভাবে ভিডিও তালিকাভুক্ত করে?

list_social_posts দিয়ে, যা account_id এবং ঐচ্ছিক limit নেয়, TikTok-এর জন্য 1 থেকে 20 পর্যন্ত। এটি TikTok-এর প্রথম পেজ ফেরত দেয়: সবচেয়ে সাম্প্রতিক পোস্ট, সঙ্গে item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments ও shares, এবং cursor ও has_more। পরের পেজ ও অন্যান্য ফিল্ড আসে আপনার নিজের কোড থেকে, get_social_credentials-এর টোকেন ও business_id দিয়ে:

The next page from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/video/list/
  ?business_id=<BUSINESS_ID>
  &fields=["item_id","media_type","caption","embed_url"]
  &cursor=1793404800000
  &max_count=20
Access-Token: <ACCESS_TOKEN>

সাধারণ ভুলগুলো

  • item_id ছাড়া ফিল্ড চাওয়া। TikTok-এর রেফারেন্স সতর্ক করে যে এটি বাদ দিয়ে একাধিক ফিল্ডের নাম নেওয়া অনুরোধ ব্যর্থ হতে পারে।
  • পেজ ছোট হয়ে এলে থেমে যাওয়া। has_more সত্য থাকা অবস্থাতেও TikTok max_count-এর চেয়ে কম পোস্ট ফেরত দিতে পারে, তাই has_more অনুসরণ করুন।
  • thumbnail_url পরে ব্যবহারের জন্য সংরক্ষণ করা। এটি একটি অস্থায়ী লিংক, যা x-expires প্যারামিটারের সময়ে মেয়াদোত্তীর্ণ হয়, তাই প্রয়োজনের সময় নতুন একটি আনুন।
  • তালিকায় ব্যক্তিগত পোস্ট খোঁজা। এন্ডপয়েন্ট শুধু পাবলিক পোস্ট ফেরত দেয়।
EasyCoexistence দিয়ে এটি করা

প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সাথে কমে, প্রথম 3 দিন বিনামূল্যে।

প্রায়শই জিজ্ঞাসিত প্রশ্ন

একবারে TikTok-এর API কতগুলো ভিডিও তালিকাভুক্ত করতে পারে?

/business/video/list/ থেকে প্রতি পেজে সর্বোচ্চ 20টি। max_count পেজের আকার ঠিক করে, ডিফল্ট 10; আরও পেতে cursor অনুসরণ করুন।

TikTok API কি ফটো পোস্টও তালিকাভুক্ত করে?

হ্যাঁ। /business/video/list/ পাবলিক ভিডিও, ফটো ও টেক্সট পোস্ট সবই ফেরত দেয়, আর media_type VIDEO ও PHOTO আলাদা করে দেখায়।

TikTok ভিডিও তালিকায় শুধু-বিজ্ঞাপনের পোস্ট থাকে কি?

হ্যাঁ। /business/video/list/ “Only show in ads” ভিডিওও ফেরত দেয়, যেগুলো প্রোফাইলে না দেখিয়ে বিজ্ঞাপন হিসেবে চলে, আর is_ad বলে দেয় কোনো পোস্ট বিজ্ঞাপনে ব্যবহৃত হচ্ছে কি না।

কেন একটি TikTok পোস্ট API তালিকা থেকে বাদ পড়ে?

এন্ডপয়েন্ট পাবলিক পোস্ট তালিকাভুক্ত করে, আর TikTok সঙ্গীতের কপিরাইটের মতো লঙ্ঘনের কারণে ফিল্টার করা পোস্ট বাদ দেয়।

আরও পড়ুন

API-এর মাধ্যমে TikTok ভিডিওর মেট্রিক: ভিউ, দেখার সময় ও সম্পূর্ণ দেখাTikTok API for Business প্রতিটি ভিডিওর ভিউ, রিচ, দেখার সময়, সম্পূর্ণ দেখার হার, রিটেনশন, ট্রাফিক উৎস ও দর্শকের দেশ ফেরত দেয়।কীভাবে API-এর মাধ্যমে TikTok-এ ভিডিও পোস্ট করবেনAPI for Business দিয়ে TikTok-এ ভিডিও পোস্ট করুন: প্রকাশ এন্ডপয়েন্ট, JSON বডি, share_id এবং স্ট্যাটাস কল, curl ও Python-এ।API-এর মাধ্যমে TikTok মন্তব্যের উত্তর ও মডারেশনTikTok API for Business-এ মন্তব্য পড়া, উত্তর দেওয়া, লুকানো ও মুছে ফেলা যায়, এবং কীওয়ার্ড নিয়ম ও অটোমেশন নতুন মন্তব্যে নিজে থেকে উত্তর দেয়।API-এর মাধ্যমে TikTok-এর দর্শক ডেমোগ্রাফিক্সTikTok-এর API for Business যে ফলোয়ারদের বয়স, লিঙ্গ, দেশ, শহর ও ঘণ্টাভিত্তিক সক্রিয়তা দেয়, এবং 100-ফলোয়ারের নিয়ম।কীভাবে API-র মাধ্যমে একটি TikTok পোস্টের প্রকাশের স্ট্যাটাস দেখবেনAPI-র মাধ্যমে প্রকাশিত TikTok পোস্ট অনুসরণ করুন: share_id, PROCESSING_DOWNLOAD, PUBLISH_COMPLETE ও FAILED স্ট্যাটাস, পোস্ট ID ও ব্যর্থতার কারণ।

দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।

প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।

  • 3 দিন ফ্রি
  • যেকোনো সময় বাতিল করুন
  • শুধুমাত্র অফিশিয়াল API
  • 24/7 পর্যবেক্ষণ

যাচাই করা হয়েছে