İçeriğe geç

Topluluk

GET/v1/twitter/community1 kredi

Bir X Topluluğunu döndürür: ad, açıklama, oluşturulma tarihi, üye sayısı, kurallar, kapak görseli, kurucu, örnek üyeler ve gündemdeki hashtag'ler.

01Sorgu parametreleri

AdTürAçıklama
urlzorunlustringTopluluğun URL'si, örneğin `https://x.com/i/communities/1926186499399139650`.

02İstek

curl "https://api.scrapesocial.ai/v1/twitter/community?url=https%3A%2F%2Fx.com%2Fi%2Fcommunities%2F1926186499399139650" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

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

GET /v1/twitter/community?url=https%3A%2F%2Fx.com%2Fi%2Fcommunities%2F1926186499399139650

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "__typename": "Community",
  "actions": {
    "id": "Q29tbXVuaXR5QWN0aW9uczoxOTI2MTg2NDk5Mzk5MTM5NjUw",
    "join_action_result": {
      "__typename": "CommunityJoinActionUnavailable"
    },
    "list_members_action_result": {
      "__typename": "CommunityListMembersAction"
    }
  },
  "created_at": 1748073622931,
  "creator_results": {
    "id": "VXNlclJlc3VsdHM6MTkyMTM2ODQ1NDQ0OTIwMTE1Mg==",
    "result": {
      "__typename": "User",
      "core": {
        "screen_name": "carsonrmccann"
      },
      "id": "VXNlcjoxOTIxMzY4NDU0NDQ5MjAxMTUy",
      "is_blue_verified": true,
      "verification": {
        "verified": false
      }
    }
  },
  "custom_banner_media": {
    "id": "QXBpTWVkaWE6DAATCgABGsjpHX8WQAEAAA==",
    "media_info": {
      "__typename": "ApiImage",
      "color_info": {
        "palette": [
          {
            "percentage": 85.22,
            "rgb": {
              "blue": 17,
              "green": 0,
              "red": 217
            }
          },
          {
            "percentage": 4.23,
            "rgb": {
              "blue": 35,
              "green": 15,
              "red": 32
            }
          }
        ]
      },
      "original_img_height": 500,
      "original_img_url": "https://pbs.twimg.com/community_banner_img/1930048753223745537/Ua814CNc?format=jpg&name=orig",
      "original_img_width": 1250
    }
  },
  "default_banner_media": {
    "id": "QXBpTWVkaWE6DAABCgABFECS7TfVcAcKAAITiFWq8lUQBAAA",
    "media_info": {
      "__typename": "ApiImage",
      "color_info": {
        "palette": [
          {
            "percentage": 36.26,
            "rgb": {
              "blue": 254,
              "green": 88,
              "red": 118
            }
          },
          {
            "percentage": 24.89,
            "rgb": {
              "blue": 168,
              "green": 101,
              "red": 250
            }
          }
        ]
      },
      "original_img_height": 480,
      "original_img_url": "https://pbs.twimg.com/media/FECS7TfVcAcCrj2.jpg",
      "original_img_width": 1200
    }
  },
  "description": "This community is for creators and builders who are growing to their first 1,000 followers. Give insights, build your brand, and grow a loyal audience.",
  "id": "Q29tbXVuaXR5OjE5MjYxODY0OTkzOTkxMzk2NTA=",
  "invites_result": {
    "__typename": "CommunityInvitesUnavailable"
  },
  "is_member": false,
  "is_nsfw": false,
  "join_policy": "Open",
  "join_requests_result": {
    "__typename": "CommunityJoinRequestsUnavailable"
  },
  "member_count": 5626,
  "members_facepile_results": [
    {
      "id": "VXNlclJlc3VsdHM6MTkyMTM2ODQ1NDQ0OTIwMTE1Mg==",
      "result": {
        "__typename": "User",
        "avatar": {
          "image_url": "https://pbs.twimg.com/profile_images/1963429128402501632/J9C5efvR_normal.jpg"
        },
        "id": "VXNlcjoxOTIxMzY4NDU0NDQ5MjAxMTUy"
      }
    },
    {
      "id": "VXNlclJlc3VsdHM6NDAwNjg4Mjc2MQ==",
      "result": {
        "__typename": "User",
        "avatar": {
          "image_url": "https://pbs.twimg.com/profile_images/2011557694264479744/xS6eyqBz_normal.jpg"
        },
        "id": "VXNlcjo0MDA2ODgyNzYx"
      }
    }
  ],
  "name": "The First Thousand",
  "rest_id": "1926186499399139650",
  "role": "NonMember",
  "rules": [
    {
      "description": "This isn’t the space to drop ChatGPT engineered empty platitudes",
      "id": "Q29tbXVuaXR5UnVsZToxOTI2MTg5OTYzNzkzNjA5MTg2",
      "name": "No Empty Platitudes",
      "rest_id": "1926189963793609186"
    },
    {
      "description": "Show how you’re cracking the algorithm",
      "id": "Q29tbXVuaXR5UnVsZToxOTI2MTkwMzM5MDE2MDQ4Njg2",
      "name": "Post What’s Working",
      "rest_id": "1926190339016048686"
    }
  ],
  "trending_hashtags_slice": {
    "__typename": "CommunityHashtagSlice",
    "items": []
  }
}

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

`created_at` milisaniye cinsinden bir Unix zaman damgasıdır. Bilinmeyen bir topluluk ücretsiz bir 404'tür (`Community not found`); `/communities/<id>` içermeyen bir URL ücretsiz bir 400 döndürür. Üyelik alanları anonim bir ziyaretçiyi yansıtır (`is_member` false).

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.