Video Arama

GET/v1/facebook/search/videos1 kredi

Facebook videolarında anahtar kelimeyle arama yapar; her video için başlık, açıklama, yükleyen, süre ve küçük resim döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
queryzorunlu	string	Aranacak anahtar kelime.
cursoristeğe bağlı	string	Önceki sayfadaki `cursor` değeri.

02İstek

curl "https://api.scrapesocial.ai/v1/facebook/search/videos?query=nasa+artemis" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/facebook/search/videos?query=nasa+artemis

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "query": "nasa artemis",
  "videos": [
    {
      "id": "1862064921793914",
      "url": "https://www.facebook.com/NASA/videos/1862064921793914/",
      "title": "NASA's Artemis III Announcement",
      "description": null,
      "author": {
        "id": "100044561550831",
        "name": "NASA - National Aeronautics and Space Administration",
        "url": "https://www.facebook.com/NASA"
      },
      "creation_time": 1781018706,
      "publish_time": 1781018706,
      "relative_time_text": "Jun 9 · 660 views",
      "duration_ms": 60000,
      "duration_text": "1:00",
      "thumbnail_url": "https://scontent.fist7-2.fna.fbcdn.net/v/t15.5256-10/719301434_1015369264305669_5708030485278968150_n.jpg?stp=c0.0.400.224a_dst-jpg_p75x225_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=e3495b&_nc_ohc=QBsAVYUoyJ8Q7kNvwEu0MGH&_nc_oc=AdpdwQ2pwduLEOr8rzOXFJiBGMjUQ8bpcYjBnmfZddKS1sX-2x4gW9ldp2DsoyVfPWCXeGu9-i2OleiMI_Cw2Zzr&_nc_zt=23&_nc_ht=scontent.fist7-2.fna&_nc_gid=q7Oxzcj5KMMbUqPAMeftz…"
    },
    {
      "id": "1724767048954925",
      "url": "https://www.facebook.com/NASA/videos/1724767048954925/",
      "title": "NASA's Artemis III Announcement",
      "description": null,
      "author": {
        "id": "100044561550831",
        "name": "NASA - National Aeronautics and Space Administration",
        "url": "https://www.facebook.com/NASA"
      },
      "creation_time": 1781027670,
      "publish_time": 1781027670,
      "relative_time_text": "Jun 9 · 5 views",
      "duration_ms": 60000,
      "duration_text": "1:00",
      "thumbnail_url": "https://scontent.fist20-1.fna.fbcdn.net/v/t15.5256-10/719754491_1205079148337425_6355070747543069493_n.jpg?stp=c0.0.400.224a_dst-jpg_p75x225_tt6&_nc_cat=101&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=e3495b&_nc_ohc=a7XPH1NN5mEQ7kNvwFft2Q8&_nc_oc=Adr0OkRy3CEdLtypb5-unN08GSIB__HCvj-aDn01guLhS3tQl6s4DVi6pVv7uZaJj5ZjNREKKMvESPG0_fI-W_uB&_nc_zt=23&_nc_ht=scontent.fist20-1.fna&_nc_gid=q7Oxzcj5KMMbUqPAMef…"
    }
  ],
  "cursor": "eyJ2IjoxLCJxdWVyeSI6Im5hc2EgYXJ0ZW1pcyIsImN1cnNvciI6IntcInBhZ2VfbnVtYmVyXCI6MCxcImZsb3dfY3Vyc29yc19zZXJpYWxpemVkXCI6e1wiSU5URVJOQUxfREVCVUdfTU9EVUxFXCI6XCJ7fVwiLFwiU0VBUkNIX0NPTlRST0xTX0lOVEVSQ0VQVFwiOlwie31cIixcIklOVEVHUklUWVwiOlwie1xcXCJoYXNfbW9yZV9yZXN1bHRzXFxcIjpmYWxzZSxcXFwicHJvY2Vzc2VkX3VuaWNvcm5faWRzXFxcIjpbXSxcXFwiaXNfZW5kX29mX3NlcnBcXFwiOmZhbHNlfVwiLFwiTUVUQV9BSVwiOlwie1xcXCJoYXNfbW9yZV9y…",
  "has_more": true
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Sonraki sayfa için yanıttaki `cursor` değerini geri gönderin; `has_more` bir sonraki sayfanın olup olmadığını gösterir. Sonuç bulunamayan bir arama 0 krediyle boş liste döndürür. Facebook yalnızca göreli bir tarih gösterdiğinde `creation_time` ve `publish_time` null olabilir; bu tarih `relative_time_text` alanında gelir.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.