הצגת סרטונים של חשבון TikTok דרך ה-API
ה-API for Business של TikTok מציג את הפוסטים הציבוריים של חשבון באמצעות GET /business/video/list/, החל מהחדש ביותר, עד 20 בעמוד. מציינים את השדות שרוצים לקבל, כגון item_id, caption, share_url ו-video_views, ומדפדפים בעזרת cursor כל עוד has_more שווה ל-true. filters.video_ids בוחר פוסטים מסוימים, וכל item_id הוא המזהה שקריאות התגובות דורשות.
easyCoexistence מציג את הפוסטים האחרונים של חשבון TikTok באמצעות list_social_posts מתוך Claude, ChatGPT או הקוד שלכם, עם item_id, כיתוב, קישור ומדדים של כל פוסט, ו-get_social_credentials נותן לקוד שלכם את האסימון לעמודים מאוחרים יותר ולשדות אחרים.
/business/video/list/ מחזיר עד מספר מרבי של פוסטים בעמוד; ברירת המחדל של max_count היא 10.
יחידת ה-cursor היא חותמת זמן Unix ב-UTC; נקודת הקצה מחזירה פוסטים שפורסמו לפניה.
שדה ברירת המחדל, שכל בקשה שמציינת כמה שדות חייבת לכלול, אחרת עלולה להיווצר שגיאה.
מספר הקריאות המותרות לכל חשבון מורשה בנקודת הקצה הזו, כמו בכל נקודות הקצה של ה-Accounts API.
מה מחזירה נקודת הקצה?
הפוסטים הציבוריים של החשבון: סרטונים שמופיעים בפרופיל, פוסטים של תמונות וטקסט, וסרטונים בשם Only show in ads, שמוצגים כמודעות בלי להופיע בפרופיל. media_type מבחין בין VIDEO ל-PHOTO, שכולל פוסטים של תמונות וטקסט. פוסטים ש-TikTok סינן בגלל הפרות, כגון זכויות יוצרים במוזיקה, לא נכללים ברשימה.
איך קוראים לנקודת הקצה?
עם GET ופרמטרים ב-URL: business_id, fields כמערך JSON, ואופציונלית filters, cursor ו-max_count, שברירת המחדל שלו היא 10. האסימון נשלח בכותרת Access-Token, ובאפליקציה למפתחים נדרשת ההרשאה Get Account Media תחת TikTok Accounts:
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: מזהה הפוסט, שקריאות התגובות וסינון לפי מזהים משתמשים בו.media_type: VIDEO, או PHOTO עבור פוסט של תמונה או טקסט.is_ad: האם הפוסט משמש במודעה.create_time: מועד פרסום הפוסט בשניות Unix, בזמן אוניברסלי מתואם.- caption: תיאור הפוסט, כולל את ההאשטאגים.
share_url: קישור לשיתוף, שמתנהג אחרת במובייל ובדסקטופ.embed_url: קישור נגן לאתרים אחרים. פוסטים שמוגדרים ל-Friends או ל-Only you לא ינוגנו דרכו.thumbnail_url: תמונת תצוגה מקדימה זמנית, שתוקפה נקבע בפרמטר x-expires שלה.video_duration: אורך הסרטון בשניות, עד שלוש ספרות אחרי הנקודה.
איך נראה עמוד של תוצאות?
מערך videos לפי הסדר שבו TikTok מחזיר אותו, בתוספת cursor, הערך לשליחה לעמוד הבא, ו-has_more, שמציין אם יש עמוד כזה. create_time מגיע כמחרוזת של שניות Unix. זו הדוגמה של TikTok, מקוצרת לשדות התיאוריים ולספירות:
{
"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 שווה ל-true. חותמת זמן מותאמת מציגה פוסטים שפורסמו לפני אותו רגע, וכללי האמון והבטיחות של TikTok יכולים לגרום לעמוד להיות קצר מ-max_count גם כשעוד פוסטים נותרו.
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 מציין את מזהי הפוסטים שיוחזרו, כמו post_ids מסטטוס פרסום. ad_post_only, תקף רק לצד video_ids, משאיר רק את הפוסטים שמורשים למפרסמים עבור Spark Ads. בקשה מסוננת מקבלת את אותם שדות כמו כל בקשה אחרת, כך שקריאה אחת יכולה להחזיר את המספרים העדכניים ביותר עבור מספר פוסטים ידועים.
filters={"video_ids":["6995316737801538821","8015388216995316737"]}אילו מגבלות חלות?
ה-Accounts API מאפשר 40 קריאות בדקה לכל חשבון מורשה בנקודת הקצה הזו, וקריאות ה-Accounts API של אפליקציה יחד מקבלות 600 בדקה ברמת Basic ו-1,000 מעליה. השדות התיאוריים מתעדכנים בזמן אמת, הספירות בדרך כלל מפגרות בין 24 ל-48 שעות, ונתוני הפוסט מפסיקים להתעדכן 365 יום אחרי שפורסם.
איך easyCoexistence מציג את הסרטונים?
עם list_social_posts, שמקבל את account_id וגם limit אופציונלי, בין 1 ל-20 עבור TikTok. הכלי מחזיר את העמוד הראשון של TikTok: הפוסטים האחרונים עם item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments ו-shares, בתוספת cursor ו-has_more. עמודים מאוחרים יותר ושדות אחרים מגיעים מהקוד שלכם, עם האסימון ו-business_id מ-get_social_credentials:
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 מזהיר שבקשה שמציינת כמה שדות בלי item_id עלולה להיכשל.
- עצירה כשעמוד חוזר קצר. TikTok יכול להחזיר פחות מ-max_count פוסטים בזמן ש-has_more עדיין שווה ל-true, לכן יש לעקוב אחרי has_more במקום.
- שמירת thumbnail_url לשימוש מאוחר יותר. זהו קישור זמני שפג בזמן הרשום בפרמטר x-expires שלו, לכן יש לשלוף קישור חדש כשצריך אותו.
- חיפוש פוסטים פרטיים ברשימה. נקודת הקצה מחזירה פוסטים ציבוריים בלבד.
US$ 9 עד US$ 0.75 לכל חיבור בחודש, יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
כמה סרטונים של TikTok מציג ה-API בבת אחת?
עד 20 בעמוד בנקודת הקצה /business/video/list/. max_count קובע את גודל העמוד וברירת המחדל שלו היא 10; עוקבים אחרי cursor כדי לקבל עוד.
האם ה-API של TikTok מציג גם פוסטים של תמונות?
כן. /business/video/list/ מחזיר סרטונים, תמונות וטקסט ציבוריים, וה-media_type מבחין ביניהם: VIDEO לסרטונים ו-PHOTO לתמונות וטקסט.
האם רשימת הסרטונים ב-TikTok כוללת פוסטים שמוצגים רק במודעות?
כן. /business/video/list/ כולל גם סרטונים בשם Only show in ads, שמוצגים כמודעות בלי להופיע בפרופיל, ו-is_ad מציין אם פוסט משמש במודעה.
מדוע פוסט של TikTok חסר ברשימה שה-API מחזיר?
נקודת הקצה מציגה פוסטים ציבוריים, ו-TikTok מוציא פוסטים שסוננו בגלל הפרות, כגון זכויות יוצרים במוזיקה.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-