İçeriğe geç

Profil

GET/v1/facebook/profile1 kredi

Bir Facebook sayfasının ya da profilinin herkese açık bilgilerini döndürür: ad, kategori, iletişim bilgileri, takipçi ve beğeni sayıları, profil ve kapak fotoğrafları, oluşturulma tarihi ve reklam yayınlayıp yayınlamadığı.

01Sorgu parametreleri

AdTürAçıklama
urlzorunlustringBir Facebook sayfası ya da profil URL'si, örneğin `https://www.facebook.com/NASA`.
get_business_hoursisteğe bağlıbooleanSayfa çalışma saatlerini gösteriyorsa `businessHours` alanını eklemek için `true` verin.Varsayılan: false
include_gated_profileisteğe bağlıbooleanUyumluluk için kabul edilir; bir etkisi yoktur.
cache_max_ageisteğe bağlıstringUyumluluk 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

02İstek

curl "https://api.scrapesocial.ai/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2FNASA" \
  -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/profile?url=https%3A%2F%2Fwww.facebook.com%2FNASA

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "adLibrary": {
    "adStatus": "This Page isn't currently running ads.",
    "pageId": "54971236771"
  },
  "creationDate": "March 4, 2009",
  "id": "100044561550831",
  "name": "NASA - National Aeronautics and Space Administration",
  "url": "https://www.facebook.com/NASA",
  "gender": "NEUTER",
  "coverPhoto": {
    "focus": {
      "x": 0.5,
      "y": 0.75161812297735
    },
    "photo": {
      "id": "1629624498532920",
      "image": {
        "uri": "https://scontent.fasr1-2.fna.fbcdn.net/v/t39.99422-6/809146614_4484013928506139_3181913787670602881_n.png?stp=dst-jpg_tt6&cstp=mx2047x1487&ctp=s2047x1487&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=Bbm8iHSal8oQ7kNvwHMMFGv&_nc_oc=AdorrB9vyArTJhgLJpxahkUpjZBPfTNRCGI8TfYjk9At9E_B78e7WGa6VZA7BSy50Fo&_nc_zt=14&_nc_ht=scontent.fasr1-2.fna&_nc_gid=hs2lO4UREgzbNbTyrbFwgA&_nc_ss=7b…",
        "width": 2047,
        "height": 1487
      },
      "viewer_image": {
        "height": 1487,
        "width": 2047
      },
      "blurred_image": {
        "uri": "https://scontent.fasr1-2.fna.fbcdn.net/v/t39.99422-6/809146614_4484013928506139_3181913787670602881_n.png?stp=dst-jpg_fb50_s320x320_tt6&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=Bbm8iHSal8oQ7kNvwHMMFGv&_nc_oc=AdorrB9vyArTJhgLJpxahkUpjZBPfTNRCGI8TfYjk9At9E_B78e7WGa6VZA7BSy50Fo&_nc_zt=14&_nc_ht=scontent.fasr1-2.fna&_nc_gid=hs2lO4UREgzbNbTyrbFwgA&_nc_ss=7b289&oh=00_AQN-Iftb…",
        "width": 320,
        "height": 232
      },
      "url": "https://www.facebook.com/photo/?fbid=1629624498532920&set=a.416660999829282"
    }
  },
  "isBusinessPageActive": false,
  "profilePhoto": {
    "url": "https://www.facebook.com/photo/?fbid=423033359192046&set=a.416661003162615",
    "viewer_image": {
      "height": 800,
      "width": 800
    },
    "id": "423033359192046"
  },
  "profilePicLarge": "https://scontent.fasr1-4.fna.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s480x480&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=CbwQIU3wAgMQ7kNvwFBrtUa&_nc_oc=AdrE4IqXRDcy0CcQztkxXG16qTOLCOMvmp4iKp64fTDMdUmYjfskaYgNWx-i7qbWZyE&_nc_zt=24&_nc_ht=scontent.fasr1-4.fna&_nc_gid=hs2lO4UREgzbNbTyrbFwgA&_nc_ss=7b289&oh=00…",
  "profilePicMedium": "https://scontent.fasr1-4.fna.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s320x320&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=CbwQIU3wAgMQ7kNvwFBrtUa&_nc_oc=AdrE4IqXRDcy0CcQztkxXG16qTOLCOMvmp4iKp64fTDMdUmYjfskaYgNWx-i7qbWZyE&_nc_zt=24&_nc_ht=scontent.fasr1-4.fna&_nc_gid=hs2lO4UREgzbNbTyrbFwgA&_nc_ss=7b289&oh=00…",
  "profilePicSmall": "https://scontent.fasr1-4.fna.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s200x200&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=CbwQIU3wAgMQ7kNvwFBrtUa&_nc_oc=AdrE4IqXRDcy0CcQztkxXG16qTOLCOMvmp4iKp64fTDMdUmYjfskaYgNWx-i7qbWZyE&_nc_zt=24&_nc_ht=scontent.fasr1-4.fna&_nc_gid=hs2lO4UREgzbNbTyrbFwgA&_nc_ss=7b289&oh=00…",
  "pageIntro": "Explore the universe and discover our home planet. \nThere's space for everybody. ✨",
  "category": "Government organization",
  "email": "[email protected]",
  "links": [],
  "website": "https://www.nasa.gov/nasa-app/",
  "ratingCount": null,
  "likeCount": 28742792,
  "talkingAboutCount": 100611,
  "followerCount": 28000000
}

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

Bilinmeyen bir sayfa `accountDoesNotExist: true` ile ücretsiz bir 404 döndürür. Adres, telefon, hizmetler, fiyat aralığı, puan ve çalışma saatleri yalnızca sayfada varsa gelir; `links` ise yalnızca sayfanın tanıtım bölümünde listeleniyorsa dolar. `ratingCount` her zaman null'dır.

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.