البدء السريع

1. احصل على مفتاح

أنشئ حسابًا وأكّد بريدك الإلكتروني. ستجد في لوحة التحكم، ضمن مفاتيح API، مفتاحًا يحمل رصيدك المجاني. يظهر المفتاح مرة واحدة فقط، فانسخه واحفظه في مكان آمن، ثم صدّره هكذا:

export CRAWLFEED_KEY="sk_live_…"

2. أرسل طلبًا

اقرأ ملفًا شخصيًا على TikTok:

curl -G https://api.crawlfeed.dev/v1/tiktok/profile \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=charlidamelio"

3. اقرأ الاستجابة

كل استجابة ناجحة على الشكل { data, meta }. الحقل data هو Profile موحّد: الحقول نفسها سواء جاء من TikTok أو YouTube أو Bluesky. أما meta فيخبرك بتكلفة الطلب ومصدر البيانات.

{
  "data": { … },            // one object, or an array on paged routes
  "meta": {
    "credits_used": 1,
    "credits_remaining": 2499,
    "cache": "MISS",          // or "HIT"
    "data_age_s": 0,          // seconds since we fetched it upstream
    "request_id": "req_01K5…",
    "next_cursor": "eyJ…"     // paged routes only, absent on the last page
  }
}

4. غيّر المنصة

ضع instagram أو youtube أو bluesky مكان tiktok، وسيعمل الكود نفسه دون تعديل. هذه هي الفكرة كلها. وتعرض صفحة كل منصة ما تقدّمه المنصة، وتكلفة كل طلب، وطلبًا جاهزًا للنسخ.

ماذا بعد؟

• صيغة الاستجابة: الغلاف، وقيم null، والحقل raw للوصول إلى البيانات الأصلية.
• التنقل بين الصفحات: استعراض منشورات ملف شخصي صفحةً بعد صفحة.
• الرصيد: تكلفة كل طلب، ومتى نردّ لك الرصيد.
• الأنواع الموحّدة: كل حقل في كل كائن.