Gönderi

GET/v1/facebook/post1 kredi

Bir Facebook gönderisini, videosunu ya da reel'ini döndürür: metin, yazar, tepki, yorum, paylaşım ve izlenme sayıları, medya bağlantıları ve ilk 10 yorum; isteğe bağlı olarak videonun dökümüyle birlikte.

01Sorgu parametreleri

Ad	Tür	Açıklama
urlzorunlu	string	Bir Facebook gönderisi, video ya da reel URL'si, örneğin `https://www.facebook.com/reel/1634870324219177`.
get_transcriptisteğe bağlı	boolean	Gönderideki videonun dökümünü `transcript` alanına eklemek için `true` verin.Varsayılan: `false`
allow_long_transcriptionisteğe bağlı	boolean	120 saniyeden uzun bir videoyu yapay zekâyla yazıya dökmek için `true` verin; başlayan her dakika 10 kredidir. Bu modu yalnızca tam olarak `true` değeri açar.Varsayılan: `false`
cache_max_ageisteğe bağlı	string	Uyumluluk için kabul edilir; her çağrı yeniden çekilir ve normal ücretlendirilir. Listede olmayan bir değer ücretsiz bir 400 ile reddedilir.Kabul edilen değerler:`1d3d7d14d30d`

02Fiyatlandırma

Gönderi 1 kredidir. `get_transcript=true` ile altyazılı ya da en fazla 120 saniyelik bir videoda fiyat 1 kredi olarak kalır; altyazısı olmayan daha uzun bir video, `allow_long_transcription=true` verilmedikçe ücretsiz bir 400 ile reddedilir, bu seçenekle bunun yerine başlayan her dakika için 10 kredi alınır. Videosu olmayan bir gönderi temel fiyatla `transcript: null` alır.

03İstek

curl "https://api.scrapesocial.ai/v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1634870324219177" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Yanıtlar

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

GET /v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1634870324219177

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "post_id": "1593991512733150",
  "like_count": 312,
  "reaction_counts": {
    "thankful": 0,
    "like": 273,
    "love": 32,
    "care": 1,
    "haha": 2,
    "wow": 4,
    "sad": 0,
    "anger": 0,
    "pride": 0,
    "confused": 0
  },
  "comment_count": 88,
  "share_count": 18,
  "view_count": 28290,
  "description": "After meeting 40,000+ people across 100 cities…\n\nI noticed something.\n\nMost people don’t have a lead problem.\n\nThey have a conversation problem.\n\nEveryone is watching:\n\nYouTube\nChatGPT\nPodcasts\nCourses\n\nBut almost nobody is talking to:\n\n• Sellers\n• Brokers\n• Owners\n• Property managers\n\nWhy?\n\nBecause the moment you talk to a real seller…\n\nYou might realize you don’t know everything.\n\nAnd most peopl…",
  "creation_time": "2026-03-08T15:55:57.000Z",
  "feedback_id": "ZmVlZGJhY2s6MTU5Mzk5MTUxMjczMzE1MA==",
  "url": "https://www.facebook.com/reel/1634870324219177",
  "image_url": null,
  "video": {
    "id": "1634870324219177",
    "sd_url": "https://video.fyei6-4.fna.fbcdn.net/o1/v/t2/f2/m412/AQNfvrmvWK1_8m9wYQbGE8x83nheuNcyg8PRylHKiagvQJAR30dCWbigqQtCU1lRak5MZPQ_drA_fHPKk0E3PYhdOeXEachqDUNSDSXN-g.mp4?_nc_cat=110&_nc_oc=Adq0Unla8YEh5GGaH9ZqIsSmDkGnywZ7hCcH10JZSm1Q_wKN24glITfvFZCChMhoc-Q&_nc_sid=8bf8fe&_nc_ht=video.fyei6-4.fna.fbcdn.net&_nc_ohc=KeXCF0VjaTsQ7kNvwFoV_qC&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYw…",
    "hd_url": "https://video.fyei6-3.fna.fbcdn.net/o1/v/t2/f2/m366/AQNjVfABeMdY6_CB2IV5L-pdvriV6PTsFjJBr1VWsPGw8TCSafFWuQKgDP1m2mjqHQQnoBWwvvAfoUtubsUpKNAr4lKZv4eTy_lnrTQ71ZJjsg.mp4?_nc_cat=107&_nc_oc=Adqm23uz7XPQjA1iXaaIQI5_8OcqWuJ6iV-XX8W1hYErjiKWeys6Y0y4DK4qwhF3GBY&_nc_sid=5e9851&_nc_ht=video.fyei6-3.fna.fbcdn.net&_nc_ohc=t02RHLq-oj0Q7kNvwFe0Nrt&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMu…",
    "height": 1280,
    "width": 720,
    "length_in_second": 31.033,
    "thumbnail": "https://scontent.fyei6-5.fna.fbcdn.net/v/t15.5256-10/649485223_1634870974219112_2297344106941848618_n.jpg?stp=dst-jpg_tt6&cstp=mx720x1280&ctp=s960x960&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=be8305&_nc_ohc=LyvuxV5iLuUQ7kNvwHNAJJv&_nc_oc=AdozlfyMfjR0wpQnGcC3CQ4GIs-3zGn5Lhroj7hJwKPr74Br6NUgOAbJpXTlGrkevMA&_nc_zt=23&_nc_ht=scontent.fyei6-5.fna&_nc_gid=cvlSaUrV0IDithANFubf7A&_nc_ss=7b289…",
    "captions_url": null
  },
  "author": {
    "id": "100063669491743",
    "name": "Pace Morby",
    "handle": "pacemorby",
    "is_verified": false,
    "url": "https://www.facebook.com/pacemorby",
    "image": "https://scontent.fyei6-1.fna.fbcdn.net/v/t39.30808-1/255454150_435897101280118_3837292553331400103_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1365x1364&ctp=s80x80&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=H08x99FEJu4Q7kNvwH6ZwlK&_nc_oc=Adr3-IwtBBPZKkZzWPH8AJFzBOSvzjzwfPLZpEV9PSQWvnFXa5SmEuU9fVj1S6a-JTU&_nc_zt=24&_nc_ht=scontent.fyei6-1.fna&_nc_gid=i8DckrsAb4GZVB6aIBBMTw&_nc_ss=7b2…"
  },
  "music": {
    "track_title": null,
    "music_album_art": "https://scontent.fyei6-1.fna.fbcdn.net/v/t39.30808-1/255454150_435897101280118_3837292553331400103_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1365x1364&ctp=s64x64&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=0fc832&_nc_ohc=H08x99FEJu4Q7kNvwH6ZwlK&_nc_oc=Adr3-IwtBBPZKkZzWPH8AJFzBOSvzjzwfPLZpEV9PSQWvnFXa5SmEuU9fVj1S6a-JTU&_nc_zt=24&_nc_ht=scontent.fyei6-1.fna&_nc_gid=i8DckrsAb4GZVB6aIBBMTw&_nc_ss=7b2…"
  }
}

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"
}

05Notlar

Facebook gönderisi olmayan bir URL ücretsiz bir 400, bilinmeyen bir gönderi ücretsiz bir 404 döndürür. Reel'lerde `music` alanı bulunur, `comments` ve `images` bulunmaz. `/watch/` ve `/videos/` URL'lerinde `share_count` null'dır; `link_attachment` yalnızca paylaşılan bağlantılarda dolar.

06Hatalar 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.