İçeriğe geç

Grup

GET/v1/facebook/group1 kredi

Bir Facebook grubunun herkese açık bilgilerini döndürür: ad, açıklama, gizlilik, üye sayısı, yöneticiler ve moderatörler, son etkinlik ve kurallar.

01Sorgu parametreleri

AdTürAçıklama
urlisteğe bağlıstringBir grup URL'si, örneğin `https://www.facebook.com/groups/366190054572553`. `url` ya da `group_id` parametrelerinden biri zorunludur.
group_idisteğe bağlıstringSayısal grup id'si. `url` ya da `group_id` parametrelerinden biri zorunludur.

02İstek

curl "https://api.scrapesocial.ai/v1/facebook/group?group_id=366190054572553" \
  -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/group?group_id=366190054572553

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "366190054572553",
  "url": "https://www.facebook.com/groups/366190054572553",
  "name": "Python Programming",
  "description": "Let's share our knowledge on Python Programming",
  "privacy": {
    "label": "Public",
    "description": "Anyone can see who's in the group and what they post."
  },
  "visibility": {
    "label": "Visible",
    "description": "Anyone can find this group."
  },
  "categories": [
    {
      "id": "242504017103922",
      "name": "Software & tech"
    },
    {
      "id": "202183377053878",
      "name": "Engineering"
    }
  ],
  "created_at": "2020-10-14T11:05:03.000Z",
  "history_summary": "Group created on October 14, 2020. Name last changed on October 16, 2020.",
  "member_count": 759475,
  "member_count_text": "759,475 total members",
  "administrator_count": 3,
  "moderator_count": 0,
  "administrators": [
    {
      "id": "pfbid029Z8KQy8d2pzM37zBUykihazPm9wT3dnm1ttPJG7uXNs248vaxAkMxGck959nmALol",
      "name": "Nusrat Jahan",
      "url": "https://www.facebook.com/people/Nusrat-Jahan/pfbid029Z8KQy8d2pzM37zBUykihazPm9wT3dnm1ttPJG7uXNs248vaxAkMxGck959nmALol/",
      "profile_picture_url": "https://scontent.fist20-1.fna.fbcdn.net/v/t39.30808-1/297738489_149183324449711_6655284279259187616_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx720x730&ctp=p64x64&_nc_cat=106&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=e99d92&_nc_ohc=MhgKTobEwTgQ7kNvwHT79mx&_nc_oc=AdrS-YKDBW9Z6QCyZek6KlFUSjLblrcdvgvQsfEARjIzvUpJQl41tZ4uFOHRT5UI-w8&_nc_zt=24&_nc_ht=scontent.fist20-1.fna&_nc_gid=BWR9Vs4W4DvynQx4PSxQ2w&_nc_ss=7b2…"
    },
    {
      "id": "100079525026696",
      "name": "Thesoftwarelion",
      "url": "https://www.facebook.com/thesoftwarelion",
      "profile_picture_url": "https://scontent.fist20-1.fna.fbcdn.net/v/t39.30808-1/242977119_109642788145497_5023972278328162431_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx1200x1200&ctp=s64x64&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=qL7C9tgAVfAQ7kNvwE3KKFj&_nc_oc=Adom6__wNFMQ0WbNeCCoPm2_AHEGOJEE3U8tGfXkVUJtNvzgCgEqfMyY-BG_l06VrVc&_nc_zt=24&_nc_ht=scontent.fist20-1.fna&_nc_gid=BWR9Vs4W4DvynQx4PSxQ2w&_nc_ss=7…"
    }
  ],
  "moderators": [],
  "activity": {
    "posts_last_day": 3,
    "posts_last_month": 348,
    "new_members_text": "No new members in the last week"
  },
  "rules": [
    {
      "id": "366191957905696",
      "title": "Be Kind and Courteous",
      "description": "We're all in this together to create a welcoming environment. Let's treat everyone with respect. Healthy debates are natural, but kindness is required."
    },
    {
      "id": "366191961239029",
      "title": "No Hate Speech or Bullying",
      "description": "Make sure everyone feels safe. Bullying of any kind isn't allowed, and degrading comments about things like race, religion, culture, sexual orientation, gender or identity will not be tolerated."
    }
  ],
  "about_info": [
    {
      "type": "XFBPrivacyGroupsAboutInfoItem",
      "label": "Public",
      "description": "Anyone can see who's in the group and what they post."
    },
    {
      "type": "XFBDiscoverabilityGroupsAboutInfoItem",
      "label": "Visible",
      "description": "Anyone can find this group."
    }
  ]
}

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 grup ücretsiz 404 döner (`Group not found`). Facebook'un yalnızca giriş yapmış kullanıcılara gösterdiği gizli bir grup ücretsiz 403 döner.

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.