البحث عبر المنصات

يُشغّل GET /v1/search?q=… استعلامًا واحدًا في عدة منصات معًا، ويعيد كائنات SearchResult، كلٌّ منها موسوم بالحقل kind (profile أو post وغيرهما). اختر المنصات بالمُعامل platforms=tiktok,youtube,x.

curl -G https://api.crawlfeed.dev/v1/search \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "q=specialty coffee" \
  --data-urlencode "platforms=tiktok,youtube,bluesky"

نتيجة كل منصة

يذكر meta.platforms حالة كل منصة طلبتها: ok أو error أو pending. المنصة التي تفشل يُردّ رصيدها وتُوسم بـ error، وتعود نتائج المنصات الأخرى كالمعتاد.

المنصات البطيئة والمهام

إذا لم تردّ بعض المنصات خلال المهلة المحددة، تكون الاستجابة 202 وفيها ما اكتمل، ومعه meta.job_id. استعلم عن GET /v1/jobs/{job_id} (مجانًا) دوريًا حتى يعيد 200.

التكلفة

مجموع أسعار البحث في كل منصة طلبتها. ويُردّ رصيد المنصات التي تفشل.

للبحث في منصة واحدة، استخدم مسارها الخاص /v1/{platform}/search. ولعدة منصات أيضًا عمليات بحث أدق، مثل search/posts وsearch/profiles؛ راجع صفحة كل منصة.