त्वरित शुरुआत

यह मार्गदर्शिका आपको List lookup endpoints का उपयोग करके सूची की जानकारी प्राप्त करने का तरीका बताती है।

पूर्वापेक्षाएँशुरू करने से पहले, आपको इनकी आवश्यकता होगी:

एक स्वीकृत ऐप के साथ डेवलपर खाता
आपके ऐप का बेयरर टोकन

ID द्वारा किसी सूची को प्राप्त करें

किसी विशिष्ट सूची का विवरण प्राप्त करें:

cURL

curl "https://api.x.com/2/lists/1234567890?\
list.fields=description,owner_id,member_count,follower_count,private,created_at" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# ID द्वारा किसी सूची को प्राप्त करें
response = client.lists.get(
    "1234567890",
    list_fields=["description", "owner_id", "member_count", "follower_count", "private", "created_at"]
)

print(f"List: {response.data.name}")
print(f"Members: {response.data.member_count}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// ID द्वारा किसी सूची को प्राप्त करें
const response = await client.lists.get("1234567890", {
  listFields: ["description", "owner_id", "member_count", "follower_count", "private", "created_at"],
});

console.log(`List: ${response.data?.name}`);
console.log(`Members: ${response.data?.member_count}`);

रिस्पॉन्स

{
  "data": {
    "id": "1234567890",
    "name": "Tech News",
    "description": "Top tech journalists and publications",
    "owner_id": "2244994945",
    "private": false,
    "member_count": 50,
    "follower_count": 1250,
    "created_at": "2023-01-15T10:00:00.000Z"
  }
}

उपयोगकर्ता के स्वामित्व वाली सूचियाँ प्राप्त करें

किसी विशेष उपयोगकर्ता के स्वामित्व वाली सभी सूचियाँ प्राप्त करें:

cURL

curl "https://api.x.com/2/users/2244994945/owned_lists?\
list.fields=description,member_count,follower_count&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# पेजिनेशन के साथ उपयोगकर्ता के स्वामित्व वाली सूचियाँ प्राप्त करें
for page in client.lists.get_owned_lists(
    "2244994945",
    list_fields=["description", "member_count", "follower_count"],
    max_results=100
):
    for lst in page.data:
        print(f"{lst.name} - {lst.member_count} members")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// पेजिनेशन के साथ उपयोगकर्ता के स्वामित्व वाली सूचियाँ प्राप्त करें
const paginator = client.lists.getOwnedLists("2244994945", {
  listFields: ["description", "member_count", "follower_count"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((lst) => {
    console.log(`${lst.name} - ${lst.member_count} members`);
  });
}

रिस्पॉन्स

{
  "data": [
    {
      "id": "1234567890",
      "name": "Tech News",
      "description": "Top tech journalists",
      "member_count": 50,
      "follower_count": 1250
    },
    {
      "id": "9876543210",
      "name": "Developer Tools",
      "description": "Useful tools for developers",
      "member_count": 25,
      "follower_count": 500
    }
  ],
  "meta": {
    "result_count": 2
  }
}

मालिक की जानकारी शामिल करें

मालिक के उपयोगकर्ता डेटा का विस्तार करें:

cURL

curl "https://api.x.com/2/lists/1234567890?\
list.fields=description,owner_id&\
expansions=owner_id&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# मालिक की जानकारी के साथ सूची प्राप्त करें
response = client.lists.get(
    "1234567890",
    list_fields=["description", "owner_id"],
    expansions=["owner_id"],
    user_fields=["username", "verified"]
)

print(f"List: {response.data.name}")
# मालिक की जानकारी response.includes.users में है

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// मालिक की जानकारी के साथ सूची प्राप्त करें
const response = await client.lists.get("1234567890", {
  listFields: ["description", "owner_id"],
  expansions: ["owner_id"],
  userFields: ["username", "verified"],
});

console.log(`List: ${response.data?.name}`);
// मालिक की जानकारी response.includes?.users में है

एक्सपैंशन के साथ रिस्पॉन्स

{
  "data": {
    "id": "1234567890",
    "name": "Tech News",
    "description": "Top tech journalists",
    "owner_id": "2244994945"
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}

उपलब्ध फ़ील्ड्स

फ़ील्ड	विवरण
`description`	सूची का विवरण
`owner_id`	स्वामी की उपयोगकर्ता ID
`private`	क्या सूची निजी है
`member_count`	सदस्यों की संख्या
`follower_count`	फ़ॉलोअर्स की संख्या
`created_at`	सूची बनाने की तारीख

अगले चरण

सूची पोस्ट्स

किसी सूची से पोस्ट्स प्राप्त करें

सूची के सदस्य

सूची के सदस्य प्राप्त करें

सूचियों का प्रबंधन

सूचियाँ बनाएँ और अपडेट करें

API संदर्भ

एंडपॉइंट का पूरा दस्तावेज़ीकरण

अवलोकन

पोस्ट्स

उपयोगकर्ता

डायरेक्ट मैसेज

लाइक्स

सूचियाँ

Spaces

Communities

Community Notes

ट्रेंड्स

समाचार

मीडिया

X गतिविधि

उपयोग

स्ट्रीम कनेक्शन

अनुपालन

Enterprise v2

लाइक्स स्ट्रीम्स

GNIP 2.0

त्वरित शुरुआत

ID द्वारा किसी सूची को प्राप्त करें

रिस्पॉन्स

उपयोगकर्ता के स्वामित्व वाली सूचियाँ प्राप्त करें

रिस्पॉन्स

मालिक की जानकारी शामिल करें

एक्सपैंशन के साथ रिस्पॉन्स

उपलब्ध फ़ील्ड्स

अगले चरण

सूची पोस्ट्स

सूची के सदस्य

सूचियों का प्रबंधन

API संदर्भ

​ID द्वारा किसी सूची को प्राप्त करें

​रिस्पॉन्स

​उपयोगकर्ता के स्वामित्व वाली सूचियाँ प्राप्त करें

​रिस्पॉन्स

​मालिक की जानकारी शामिल करें

​एक्सपैंशन के साथ रिस्पॉन्स

​उपलब्ध फ़ील्ड्स

​अगले चरण

सूची पोस्ट्स

सूची के सदस्य

सूचियों का प्रबंधन

API संदर्भ

ID द्वारा किसी सूची को प्राप्त करें

रिस्पॉन्स

उपयोगकर्ता के स्वामित्व वाली सूचियाँ प्राप्त करें

रिस्पॉन्स

मालिक की जानकारी शामिल करें

एक्सपैंशन के साथ रिस्पॉन्स

उपलब्ध फ़ील्ड्स

अगले चरण