POST$0.0013 لكل طلب · $1.30 لكل 1,000 طلب

البحث عن الإعلانات

نقطة النهاية

POST https://getvibeapi.com/v1/social/tiktok/ads/search_ads

مثال

curl -sS "https://getvibeapi.com/v1/social/tiktok/ads/search_ads" \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{}'

أرسل مفتاحك في ترويسة Authorization: Bearer. تدفع فقط مقابل الطلبات التي يقبلها موفّر البيانات. لا تُحتسب تكلفة الطلبات التي يرفضها (الأخطاء، أو انتهاء المهلة، أو المعلمات غير الصالحة). ويُحتسب الطلب الصالح الذي يعيد من المنصة نتيجة فارغة أو نتيجة تفيد بعدم العثور عليها.

المعلمات

objective

body · عدد صحيح

Ad objective (optional; 1: 2: 3: 4: 5: 6: 7:)

like

body · عدد صحيح

Performance rank (optional; 1:1-20% 2:21-40% 3:41-60% 4:61-80% 5:81-100%)

period

body · عدد صحيح

الفترة الزمنية (بالأيام)

industry

body · سلسلة نصية

معرّف المجال

keyword

body · سلسلة نصية

الكلمة المفتاحية للبحث

page

body · عدد صحيح

رقم الصفحة

limit

body · عدد صحيح

عدد العناصر في الصفحة

order_by

body · سلسلة نصية

الترتيب حسب (for_you, likes)

country_code

body · سلسلة نصية

رمز البلد

ad_format

body · عدد صحيح

تنسيق الإعلان (اختياري؛ 1:Spark Ads 2:Non-Spark Ads)

ad_language

body · سلسلة نصية

لغة الإعلان (اختياري)

duration

body · عدد صحيح

قيمة عامل تصفية مدة الفيديو (اختياري)

pattern_label

body · سلسلة نصية

تسمية النمط الإبداعي (اختياري)

search_id

body · سلسلة نصية

معرّف البحث (اختياري)

cookie

body · سلسلة نصية

ملف تعريف الارتباط

الاسم	داخل	النوع	مطلوب	الوصف
objective	body	integer	لا	Ad objective (optional; 1: 2: 3: 4: 5: 6: 7:)
like	body	integer	لا	Performance rank (optional; 1:1-20% 2:21-40% 3:41-60% 4:61-80% 5:81-100%)
period	body	integer	لا	الفترة الزمنية (بالأيام)
industry	body	string	لا	معرّف المجال
keyword	body	string	لا	الكلمة المفتاحية للبحث
page	body	integer	لا	رقم الصفحة
limit	body	integer	لا	عدد العناصر في الصفحة
order_by	body	string	لا	الترتيب حسب (for_you, likes)
country_code	body	string	لا	رمز البلد
ad_format	body	integer	لا	تنسيق الإعلان (اختياري؛ 1:Spark Ads 2:Non-Spark Ads)
ad_language	body	string	لا	لغة الإعلان (اختياري)
duration	body	integer	لا	قيمة عامل تصفية مدة الفيديو (اختياري)
pattern_label	body	string	لا	تسمية النمط الإبداعي (اختياري)
search_id	body	string	لا	معرّف البحث (اختياري)
cookie	body	string	لا	ملف تعريف الارتباط

الحصول على مفتاح API جميع طرق TikTok