{"uid":"cap_byE7EpDcTSXMxMa4noXgD","slug":"x402-twit-sh-d2f3199c","name":"x402.twit.sh Twitter/X List Lookup by ID","description":"Retrieve details of a specific Twitter/X List by its numeric ID. Returns name, description, mode, member count, subscriber count, creation date, banner image, and owner profile. Query param: id (string, required) - numeric List ID, e.g. GET /lists/by/id?id=84839422. Returns X v2 API-compatible JSON.","url":"https://x402.twit.sh/lists/by/id?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Numeric Twitter/X List ID"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"id":"84839422","mode":"Public","name":"Crypto General","owner":{"id":"9253672","name":"Hal Finney","username":"halfin","verified":false,"description":"Running bitcoin.","public_metrics":{"like_count":300,"tweet_count":600,"followers_count":134000,"following_count":200}},"created_at":"2022-04-10T11:43:59.000Z","description":"General crypto tech and market commentary","member_count":110,"subscriber_count":3970}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"id":"84839422"}}},"response":{"data":{"id":"84839422","mode":"Public","name":"Official Twitter Accounts","owner":{"id":"783214","name":"X","entities":{"url":{"urls":[{"url":"https://t.co/Xp0xJlcROt","indices":[0,23],"display_url":"x.com","expanded_url":"https://x.com"}]},"description":{}},"username":"X","verified":true,"description":"what's happening?!","verified_type":"Business","public_metrics":{"like_count":5986,"media_count":2489,"tweet_count":15701,"listed_count":85267,"followers_count":60863753,"following_count":1},"profile_image_url":"https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_normal.jpg","profile_banner_url":"https://pbs.twimg.com/profile_banners/783214/1690175171"},"created_at":"2013-02-05T18:14:21.000Z","description":"Accounts managed by Twitter, Inc.","member_count":81,"subscriber_count":982}}},"exampleRequest":{"id":"84839422"},"tags":["x402"],"displayCostAmount":"0.0025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bvzevGeiDE17RgjH0TeVV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieve metadata for a specific Twitter/X List by its numeric ID, including name, description, member count, and owner profile.","exampleAgentPrompt":"Can you pull up the details for Twitter list 84839422 — I want to know its name, description, how many members it has, and who owns it?","exampleUseCases":null,"resultDescription":"Returns an X v2 API-compatible JSON object containing the list's name, description, mode (public/private), member count, subscriber count, creation timestamp, banner image URL, and the owner's profile information.","failureModes":["Invalid or non-numeric List ID returns an error response","List does not exist or has been deleted returns 404-equivalent","Private list not accessible returns permission error","Missing required 'id' query parameter causes validation error","Payment failure via x402 protocol prevents access"],"whenToPreferThis":"Use this endpoint when you need structured metadata about a specific Twitter/X List and already have its numeric ID. Ideal for enriching list references with human-readable names, descriptions, and ownership data without scraping the Twitter web UI.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T00:44:14.899Z","isFirstParty":false,"canonicalSlug":"x402-twit-sh-d2f3199c"}