المرجع

الأنواع الموحّدة

مولَّدة من المخططات نفسها التي تتحقق بها واجهة API من استجاباتها. ويحمل كل كائن أيضًا الحقول الأساسية (platform وid وurl وfetched_at وsource).

Profile Post Comment Transcript Summary Audience Track Collection Ad Advertiser LiveStream Event Suggestion LinkedProfile Product Review WebResult SearchResult

Profile

شخص أو صفحة أو قناة أو مجتمع أو شركة أو فنان.

الحقل	النوع	ملاحظات
handle	string
display_name	string	قد يكون null
bio	string	قد يكون null
avatar_url	url	قد يكون null
verified	boolean
followers	integer	قد يكون null
following	integer	قد يكون null
posts_count	integer	قد يكون null
lang	string	قد يكون null
country	string	قد يكون null
links	url[]

Post

كل ما يُنشر: فيديو أو تغريدة أو ريل أو Pin أو سلسلة أو سناب أو منشور في subreddit.

الحقل	النوع	ملاحظات
author	object
author.platform	Platform
author.id	string
author.handle	string
author.display_name	string	قد يكون null
author.avatar_url	url	قد يكون null
text	string
lang	string	قد يكون null
created_at	datetime	قد يكون null
media	Media[]
media[].type	"image" \| "video" \| "audio"
media[].url	url
media[].thumbnail_url	url	قد يكون null
media[].duration_s	number	اختياري
engagement	Engagement
engagement.likes	integer	قد يكون null
engagement.comments	integer	قد يكون null
engagement.shares	integer	قد يكون null
engagement.views	integer	قد يكون null
engagement.saves	integer	قد يكون null
hashtags	string[]
mentions	string[]
is_ad	boolean

Comment

تعليق أو رد. تحمل الردود الحقل reply_to_id.

الحقل	النوع	ملاحظات
post_id	string
author	object
author.platform	Platform
author.id	string
author.handle	string
author.display_name	string	قد يكون null
author.avatar_url	url	قد يكون null
text	string
lang	string	قد يكون null
created_at	datetime	قد يكون null
likes	integer	قد يكون null
reply_to_id	string	قد يكون null

Transcript

الكلام المنطوق في منشور فيديو أو صوت، مع مقاطع موقّتة عند توفرها.

الحقل	النوع	ملاحظات
post_id	string
lang	string	قد يكون null
text	string
segments	TranscriptSegment[]
segments[].start_s	number	قد يكون null
segments[].end_s	number	قد يكون null
segments[].text	string

Summary

ملخص فيديو مكتوب بالذكاء الاصطناعي من نصه المفرّغ: بضع جمل وأبرز النقاط والمواضيع.

الحقل	النوع	ملاحظات
post_id	string
lang	string	قد يكون null
summary	string
key_points	string[]
topics	string[]
model	string

Audience

أين يوجد جمهور صانع المحتوى، موزّعًا حسب الدولة.

الحقل	النوع	ملاحظات
handle	string
countries	AudienceCountry[]
countries[].country	string	قد يكون null
countries[].name	string
countries[].share	number
countries[].count	integer	قد يكون null

Track

مقطع موسيقي أو صوتي: أغنية على Spotify أو صوت على TikTok.

الحقل	النوع	ملاحظات
title	string
artists	string[]
album	string	قد يكون null
duration_s	number	قد يكون null
cover_url	url	قد يكون null
audio_url	url	قد يكون null
released_at	datetime	قد يكون null
plays	integer	قد يكون null
posts_count	integer	قد يكون null
explicit	boolean	قد يكون null

Collection

مجموعة عناصر لها اسم: قائمة تشغيل أو لوحة أو قصص مميزة أو ألبوم أو بودكاست.

الحقل	النوع	ملاحظات
kind	"playlist" \| "board" \| "highlight" \| "album" \| "podcast"
title	string
description	string	قد يكون null
owner	object	قد يكون null
owner.platform	Platform
owner.id	string
owner.handle	string
owner.display_name	string	قد يكون null
owner.avatar_url	url	قد يكون null
items_count	integer	قد يكون null
cover_url	url	قد يكون null
created_at	datetime	قد يكون null

إعلان واحد من مكتبة إعلانات عامة.

الحقل	النوع	ملاحظات
advertiser	AdvertiserSummary
advertiser.id	string	قد يكون null
advertiser.name	string
advertiser.url	url	قد يكون null
text	string
headline	string	قد يكون null
media	Media[]
media[].type	"image" \| "video" \| "audio"
media[].url	url
media[].thumbnail_url	url	قد يكون null
media[].duration_s	number	اختياري
call_to_action	string	قد يكون null
landing_url	url	قد يكون null
started_at	datetime	قد يكون null
ended_at	datetime	قد يكون null
is_active	boolean	قد يكون null
countries	string[]
formats	string[]

Advertiser

معلِن موجود في مكتبة إعلانات.

الحقل	النوع	ملاحظات
name	string
avatar_url	url	قد يكون null
country	string	قد يكون null
ads_count	integer	قد يكون null
domains	string[]

LiveStream

هل صانع المحتوى في بث مباشر الآن، وتفاصيل البث.

الحقل	النوع	ملاحظات
host	object
host.platform	Platform
host.id	string
host.handle	string
host.display_name	string	قد يكون null
host.avatar_url	url	قد يكون null
is_live	boolean
title	string	قد يكون null
viewers	integer	قد يكون null
likes	integer	قد يكون null
started_at	datetime	قد يكون null
thumbnail_url	url	قد يكون null

Event

فعالية عامة أو بث مُجدول.

الحقل	النوع	ملاحظات
name	string
description	string	قد يكون null
starts_at	datetime	قد يكون null
ends_at	datetime	قد يكون null
location	string	قد يكون null
host	object	قد يكون null
host.platform	Platform
host.id	string
host.handle	string
host.display_name	string	قد يكون null
host.avatar_url	url	قد يكون null
cover_url	url	قد يكون null
going	integer	قد يكون null
interested	integer	قد يكون null
is_online	boolean	قد يكون null

Suggestion

ما يقترحه مربع البحث أثناء الكتابة: عبارة بحث أو حساب.

الحقل	النوع	ملاحظات
text	string
kind	"query" \| "profile"
profile	object	قد يكون null
profile.platform	Platform
profile.id	string
profile.handle	string
profile.display_name	string	قد يكون null
profile.avatar_url	url	قد يكون null
position	integer	قد يكون null

LinkedProfile

أحد حسابات صانع المحتوى على منصة أخرى، مع درجة الثقة في المطابقة.

الحقل	النوع	ملاحظات
handle	string
confidence	number
evidence	string[]

Product

منتج معروض في متجر أو سوق إلكتروني.

الحقل	النوع	ملاحظات
store	StoreSummary
store.platform	Platform
store.id	string
store.name	string
store.url	url
title	string
description	string	قد يكون null
price	Price
price.amount	number
price.currency	string
images	url[]
in_stock	boolean
rating	number	قد يكون null
reviews_count	integer	قد يكون null
categories	string[]

Review

مراجعة لمنتج.

الحقل	النوع	ملاحظات
product_id	string
author	object
author.platform	Platform
author.id	string
author.handle	string
author.display_name	string	قد يكون null
author.avatar_url	url	قد يكون null
rating	number
text	string
lang	string	قد يكون null
created_at	datetime	قد يكون null

WebResult

نتيجة بحث ويب عادية (غير إعلانية).

الحقل	النوع	ملاحظات
title	string
snippet	string	قد يكون null
domain	string
position	integer	قد يكون null
published_at	datetime	قد يكون null

SearchResult

نتيجة بحث واحدة، موسومة بالحقل kind.

الحقل	النوع	ملاحظات
kind: "profile"	object
kind: "post"	object
kind: "comment"	object
kind: "product"	object
kind: "review"	object
kind: "track"	object
kind: "collection"	object
kind: "web"	object