نحوه ارسال و دریافت تجزیه و تحلیل با استفاده از API Tiktok

adminآگوست 19, 2025

0 80 خواندن این مطلب 8 دقیقه زمان میبرد

نحوه ارسال و دریافت تجزیه و تحلیل با استفاده از API Tiktok

نادیده گرفتن اثرات Tiktok غیرممکن است. این ماه بیش از 1.5 میلیارد کاربر فعال در ماه دارد. هر یک از این کاربران هفته ای بیش از 6 ساعت در هفته را در حال تماشای فیلم ها می گذرانند.

این پلتفرم بسیار فراتر از منشأ فیلم های رقص گسترش یافته است ، اکنون طیف متنوعی از مطالب را در موضوعات مختلف پوشش می دهد. نگهداری آن برای چندین قالب ویدیویی – عمودی ، افقی و مربع – بر سازگاری و جذابیت گسترده آن تأکید دارد.

برای سازندگان تجارت و محتوا ، Tiktok فرصتی بلااستفاده برای رشد و تعهد مخاطب است. استفاده از رابط برنامه Tiktok (API) برای توزیع ویدیو یک حرکت SMARTC برای کسانی است که از قبل محتوای ویدیویی تولید می کنند. در این مقاله یک راهنمای جامع API Tiktok برای به حداکثر رساندن محتوای و تأثیر شما بر این بستر تأثیرگذار ارائه شده است.

چرا Tiktok برای تجارت شما مهم است

مطالعات اخیر نشان داده است که Tiktok بیش از 18 سال به بیش از 50 ٪ از کاربران اینترنت در ایالات متحده رسیده است. این تعداد برای سایر کشورها حتی بیشتر است. این کاربران همچنین پول را برای این سیستم عامل خرج می کنند ، زیرا Tiktok به تازگی به اولین برنامه Nesiga تبدیل شده است که بیش از 10 میلیارد دلار هزینه مصرف کننده است.

این شماره های مصرف فقط به این دلیل افزایش می یابد که Tiktok اکنون با فروشگاه های Tiktok به یک سایت تجارت الکترونیکی تبدیل شده است. این شروع به مارک ها اجازه می دهد تا به درستی در سکوی Tiktok ، با صفحات محصول ، چرخ دستی های خرید و ترک تلاش ، به مشتریان برسند. فروشگاه Tiktok برای محصولات دیجیتال و فیزیکی کار می کند.

آشنایی با چشم انداز Tiktok API

Tiktok شامل تعدادی API است ، از جمله: ورودی ، نمایش ، محتوای تجاری ، تحقیق و ارسال محتوا – فیلم ها و عکس ها. این پست وبلاگ برای ارسال محتوای ویدیویی روی API متمرکز خواهد شد. Tiktok یک کیت توسعه نرم افزار (SDK) را برای Android و iOS منتشر کرده است.

محتوایی که Tiktok API منتشر می کند ، به برنامه های وب و تلفن همراه اجازه می دهد تا از پلت فرم Tiktok استفاده کنند. API برای ارسال محتوا 2 پیشنهاد دارد:

انتشار مستقیم – این روش به شما امکان می دهد مستقیماً از برنامه خود به Tiktok ارسال کنید. این شامل فیلم ، کتیبه و هشتگ است.
بارگذاری کردن – بار دیگر ، کاربر فقط می تواند ویدیو را در Tiktok بارگذاری کند و سپس پست ویدیو را از برنامه Tiktok نهایی کند. پس از بارگذاری این فیلم از طریق API ، از طریق برنامه Tiktok یک اعلان دریافت خواهید کرد که یک فیلم جدید برای بررسی و ارسال دارید.

آماده سازی برای استفاده از API Tiktok

ثبت نام کنید و یک برنامه ایجاد کنید
1. وارد پورتال توسعه دهنده شوید یا وارد Tiktok شوید.
2. بخش مدیریت برنامه حساب خود را باز کنید.
3. روی “اتصال برنامه” کلیک کنید و جزئیات را وارد کنید:
4. روی تأیید کلیک کنید.
تنظیمات را پیکربندی کنید
1. تمام جزئیات مورد نظر برنامه را تکمیل کنید ، از جمله: نماد ، نام ، دسته ، توضیحات ، URL TOS و URL سیاست حفظ حریم خصوصی.
2. انتخاب کنید که کدام سکوی را می سازید. می توانید وب را انتخاب کرده و URL خود را وارد کنید.
3. روی “ذخیره تغییرات” کلیک کنید.
ارسال برای بررسی
1. روی دکمه “ارسال برای بررسی” کلیک کنید.
2. دلیل ارسال را وارد کنید.
3. روی ارسال کلیک کنید.
4. این شرط در حال حاضر “در حال بررسی” است ، منتظر جواب باشید.

ارسال شما برای تأیید پیروی از شرایط Tiktok حسابرسی شده است. این می تواند چند روز تا چند هفته طول بکشد و به نظرات اضافی مانند ویدیوی برنامه شما نیاز دارد.

از کاربران خود اجازه دریافت کنید

برنامه شما باید از کاربران خود بخواهد تا آن را برای مدیریت حساب های Tiktok خود ترک کنند. این کار با کمک کد مجوز OAUTH 2.0 انجام می شود. پس از تأیید کاربر با Tiktok و اجازه برنامه ، یک نشانگر دسترسی کاربر را تولید می کند که به برنامه شما اجازه می دهد تا تماس های API را برای کار حساب کاربری از طرف آنها برقرار کند.

از آنجا که مستندات API برای احراز هویت و مجوز جامع و دقیق است ، ما مراحل را در اینجا تکرار نمی کنیم. اما یک چیز را باید در خاطر داشته باشید:

نشانه های دسترسی هر 24 ساعت یکبار منقضی می شوند ، اما بدون رضایت کاربر می توان آنرا تازه کرد. با آنها مانند رمزهای عبور رفتار کنید و آنها را به طور ایمن در پایگاه داده کاربر خود ذخیره کنید. نشانگرهای دسترسی Tiktok را بررسی کنید.

اولین ویدیوی خود را با Tiktok API بارگذاری کنید

برای بارگذاری ویدیو برای به اشتراک گذاشتن یک نقطه پایانی پست Tiktok:

POST https://open.tiktokapis.com/v2/post/publish/inbox/video/init

بدنه درخواست JSON شیء است:

{
    "source_info": {
        "source": "PULL_FROM_URL",
        "video_url": "https://url-to-your-video"
    }
}

source: 2 گزینه برای منبع وجود دارد. استفاده کردن PULL_FROM_URL هنگامی که فیلم منبع در URL است. برای استفاده از پرونده های محلی FILE_UPLOAD با Video_Size ، chunk_size و total_chunk_count باید نشان داده شود. مراجعه به پرونده Tiktok API تماس تلفنی Clayho برای داده های خاص.
video_url: منبع URL ویدئویی که باید منتشر شود

همیشه این دو هدر درخواست را اضافه کنید:

Authorization: Bearer {access_token}
Content-Type: application/json

اگر درخواست موفق شود ، پاسخ HTTP 200 (OK) و JSON را دریافت می کنید:

{
    "data": {
        "publish_id": "v_inbox_url~v2.123456789"
    },
    "error": {
         "code": "ok",
         "message": "",
         "log_id": "202312192248442CB9319E1FB30C1073F4"
     }
}

کد با استفاده از node.js سرور با JavaScript:

const accessToken = USER-ACCESS-TOKEN;

const headers = {
  'Authorization': `Bearer ${accessToken}`,
  'Content-Type': 'application/json'
};

const params = {
  "source_info": {
        "source": "PULL_FROM_URL",
        "video_url": "https://url-to-your-video"
    }
};

const postResp = await fetch(
    'https://open.tiktokapis.com/v2/post/publish/inbox/video/init', {
      method: 'POST',
      headers: headers,
      body: JSON.stringify(params)
});

console.log(postResp.status);
if (postResp.ok) {
  const publishId = postResp.json().data.publish_id;
  console.log(publishId);
}

مجوز URL Tiktok

Tiktok اخیراً امنیت خود را تقویت کرده و نیاز به بررسی تمام دامنه های URL در کشش دارد. این بدان معنی است که شما باید دامنه خود را با Tiktok ثبت کنید و با افزودن یک رشته امضا به سوابق DNS دامنه ، ویژگی را بررسی کنید.

به عنوان یک گزینه دیگر ، می توانید مستقیماً پرونده ای را در Tiktok بارگذاری کنید که نیازی به اثبات خاصیت ندارد.

دریافت وضعیت ارسال ویدیوی Tiktok

حتی اگر شما فیلم را با موفقیت بارگذاری کرده اید ، این بدان معنی نیست که این فیلم با موفقیت در Tiktok منتشر شده است – همچنین URL واقعی این فیلم کجاست؟

برای به دست آوردن وضعیت پست ویدیویی و ابرداده های دیگر ، باید یک تماس دیگر در این فرآیند برقرار کنید. با انتشار منتشر شده ، از تماس تلفنی بازگشت:

curl --location 'https://open.tiktokapis.com/v2/post/publish/status/fetch/' \
--header 'Authorization: Bearer act.example12345Example12345Example' \
--header 'Content-Type: application/json; charset=UTF-8' \
--data '{
    "publish_id": "v_pub_url~v2.123456789"
}'

هنگامی که این فیلم پردازش را به پایان رسانده است ، الف PUBLISH_COMPLETE از نقطه پایان پست Tiktok بازگردانده می شود:

{
    "data": {
        "status": "PUBLISH_COMPLETE",
        "publicaly_available_post_id": ["2392k292932dkew93"],
        "uploaded_bytes": 10000
    }
}

استفاده publicaly_available_post_id fieldURL را به ویدیوی واقعی Tiktok بسازید ، مانند:

`https://www.tiktok.com/@${username}/video/${publicaly_available_post_id}`

فیلم های Tiktok برای تکمیل پردازش بین 30 ثانیه و 2 دقیقه طول می کشد ، بنابراین احتمالاً شما نیاز به چند تماس دارید. اگر فیلم هنوز در حال پردازش باشد ، وضعیتی از آن دریافت خواهید کرد PROCESSING_UPLOAD و در صورت عدم موفقیت انتشار ، شرط خواهد بود FAILEDحرف

تجزیه و تحلیل برای ارسال با Tiktok API دریافت کنید

Tiktok تجزیه و تحلیل را برای پست ها با استفاده از نقطه انتهایی درخواست های نمایشگر API در صفحه نمایش گزارش می دهد. جزئیات فیلم را برمی گرداند و حتی می تواند برای تازه کردن تصویر جلد ویدیویی استفاده شود.

POST https://open.tiktokapis.com/v2/video/query/?fields=id,title,like_count,comment_count,share_count,view_count

fields: پارامتر درخواست کنید تا مشخص شود جزئیات ویدیویی مورد نیاز است

بدنه درخواست باید لیستی از video_idss a video_id بر خلاف انتشار بارگذاری ، می توان آن را از یک پست مستقیم بدست آورد. بدنه پست مانند موارد زیر با حداکثر 20 ویدیویی به نظر می رسد:

{
    "filters": {
        "video_ids": [
            "1234123412345678567",
            "1010102020203030303"
        ]
    }
}

داده های موجود در پاسخ به این شکل خواهند بود:

{
  "data":{
      "videos":[
         {
            "title":"Video 1",
            "id":"1234123412345678567",
            "like_count":23,
            "comment_count":3,
            "share_count":1,
            "view_count":356
         },
         {
            "title":"Video 2",
            "id":"1010102020203030303",
            "like_count":23,
            "comment_count":3,
            "share_count":1,
            "view_count":356
         }
      ]
   },
   "error": {
      "code":"ok",
      "message":"",
      "log_id":"20231299194722CBE87ED59D524E727021"
   }
}

API جایگزین برای رسانه های اجتماعی برای Tiktok

به عنوان جایگزینی برای ادغام API Tiktok به طور مستقیم و جستجوی جستجوی API Ayrshare برای API برای ارسال پست ، تجزیه و تحلیل پیشرفته و مدیریت نظرات Tiktok.

Ayrshare را تنظیم کنید

با Ayrshare API فقط در سه مرحله شروع کنید:

در پلت فرم Ayrshare ثبت نام کنید.
کلید API را در داشبورد کنترل صفحه API بگیرید.
تصمیم بگیرید که از کجا ارسال کنید. برای ارسال در حساب Tiktok ، حساب ما را دنبال کنید تا حساب خود را وصل کنید و Tiktok را وصل کنید.

همه شما آماده استفاده از API ما هستید همانطور که در مثالهای زیر نشان داده شده است.

فیلم های خود را با استفاده از پایتون در Tiktok ارسال کنید

آیا می خواهید به طور خودکار در صفحه Tiktok خود ارسال کنید؟ به عنوان مثال ، هر بار که افراد بازاریابی شما یک فیلم مفید را برای نشان دادن یک محصول بارگذاری می کنند ، ممکن است بخواهید یک فیلم کوتاه را که ترویج این تظاهرات است ، به اشتراک بگذارید.

برای انجام این کار ، فقط با ویدیوی خود در پارامتر MediaUrls ، نقطه پایانی Ayrshare /Post را تماس بگیرید.

توجه: برای ارسال فیلم به یک برنامه حق بیمه یا تجاری نیاز دارید ، اما پست ها و پست های متن با یک تصویر در دسترس همه برنامه ها است.

import os
import requests

# Add the API key to your application’s environment.
#     export AYRSHARE_API_KEY=YOUR-AYRSHARE-API-KEY

params = {
    'post': 'The latest product demonstration video’,
    'mediaUrls': ['https://TRAINING-VIDEO-LINK'],
    'platforms': ['tiktok']
}

headers = {
    'Authorization': f'Bearer {os.environ["AYRSHARE_API_KEY"]}',
    'Content-Type': 'application/json'
}

r = requests.post('https://app.ayrshare.com/api/post',
    json=params, headers=headers)
ret = r.json()

پاسخ JSON را دریافت خواهید کرد:

{
  "status": "success",
  "errors": [],
  "postIds": [{
    "status": "success",
    "platform": "tiktok",
    "idShare": "video.678746453423652.nzLqBNMwp",
    "id": "pending"
   }],
 “id": "JsuoeTwnUSncp",
 “refId”: “34a87acb33af0909f416ac“,
 "post": "The latest product demonstration video"
}

همچنین می توانید از بسته API PYPI اجتماعی استفاده کنید تا تماس ها ساده تر یا یکی دیگر از بسته های SDK ما در رسانه های اجتماعی باشد.

برای پست های خود با Ayrshare تجزیه و تحلیل کنید

با استفاده از Endpoint /Analytics ، می توانید ایده ای در مورد نحوه ارائه یک پست دریافت کنید و آنها را به کاربران خود ارائه می دهید:

POST https://app.ayrshare.com/api/analytics/post

Ayrshare حاوی بینش های زیادی برای تجزیه و تحلیل Tiktok در یک پست است ، برخی از آنها منحصر به Ayrshare ، مانند اطلاعات جمعیتی:

...
"tiktok": {
        "id": "7034682002927550598",    // TikTok Social ID
        "postUrl": "https://www.tiktok.com/@borneild/video/7034682002927550598?utm_campaign=tt4d_open_api&utm_source=awawnhyictaos7o",
        "analytics": {
            "audienceCountries": [    // Available 24-48 hours after posting
                {
                    "country": "BM",
                    "percentage": 0.0036
                },
                {
                    "country": "MX",
                    "percentage": 0.0072
                },
                {
                    "country": "PH",
                    "percentage": 0.0036
                },
                {
                    "country": "US",
                    "percentage": 0.9819
                },
                {
                    "country": "VN",
                    "percentage": 0.0036
                }
            ],
            "averageTimeWatched": 5.6679,    // Available 24-48 hours after posting.
            "caption": "Scramble up ur name & I’ll try to guess it😍❤️ #foryoupage #petsoftiktok #aesthetic",
            "comments": 23,
            "created": "2022-08-09T15:08:22Z",
            "embedUrl": "https://www.tiktok.com/embed/v2/7129893524253756713",
            "fullVideoWatchedRate": 0.0866, // Percentage of views that completed watching the full video. Available 24-48 hours after posting.
            "impressionSources": [ // Different sources for the impressions, ranked from the largest contribution to the smallest. Available 24-48 hours after posting.
                {
                    "impression_source": "Search",
                    "percentage": 0.0217
                },
                {
                    "impression_source": "Sound",
                    "percentage": 0
                },
                {
                    "impression_source": "Follow",
                    "percentage": 0
                },
                {
                    "impression_source": "For You",
                    "percentage": 0.917
                },
                {
                    "impression_source": "Hashtag",
                    "percentage": 0
                },
                {
                    "impression_source": "Personal Profile",
                    "percentage": 0
                }
            ],
            "likes": 22,
            "mediaType": "video",
            "musicTitle": "♬ original sound - tiff",    // If available
            "musicUrl": "https://www.tiktok.com/music/original-sound-6689804660171082501?refer=embed", // if available
            "name": "Mackly",
            "postUrl": "https://www.tiktok.com/@tiktoktime/video/7129893524253756713?utm_campaign=tt4d_open_api&utm_source=awawnhyictaos7o7",
            "reach": 252, // Total number of unique users who viewed the video. Available 24-48 hours after posting.
            "shares": 0,
            "shareUrl": "https://www.tiktok.com/@tiktoktime/video/7129893524253756713?utm_campaign=tt4d_open_api&utm_source=awawnhyictaos7o7", // Deprecated, user postUrl
            "tags": [    // Tags included in the description
                {
                    "tag": "#foryoupage",
                    "url": "https://www.tiktok.com/tag/foryoupage"
                },
                {
                    "tag": "#petsoftiktok",
                    "url": "https://www.tiktok.com/tag/petsoftiktok"
                },
                {
                    "tag": "#aesthetic",
                    "url": "https://www.tiktok.com/tag/aesthetic"
                }
            ],
            "thumbnailHeight": 576,
            "thumbnailUrl": "https://p16-sign.tiktokcdn-us.com/obj/tos-useast5-p-0068-tx",
            "thumbnailWidth": 1006,
            "url": "https://www.tiktok.com/@tiktoktime",
            "videoDuration": 13.984,
            "videoViews": 34
        },
        "lastUpdated": "2022-04-23T18:44:29.778Z",
        "nextUpdate": "2022-04-23T19:19:29.778Z"
    }
...

برای جزئیات بیشتر به API Analytics مراجعه کنید.

بازاریابی B2B کاربران خود را با استفاده از API Tiktok تقویت کنید

این مقاله شما را با استفاده از فرصت های ارسال API Tiktok ، بازاریابی مؤثرتر B2B را آشنا کرد. برای API بیشتر در رسانه های اجتماعی ، مقالات ما را در مورد بهترین بستر رسانه های اجتماعی برای جذب مشتریان B2B و 10 API برتر برای رسانه های اجتماعی برای توسعه دهندگان بخوانید.

Source link

adminآگوست 19, 2025

0 80 خواندن این مطلب 8 دقیقه زمان میبرد