{"uid":"cap_i_NSMk_vng024pOnzYeGw","slug":"readx-list-lookup-api-3b51f655","name":"ReadX List Lookup API","description":"ReadX is a read-only X/Twitter JSON API. Profiles, timelines, tweets, search, lists, followers & following — pay per call with x402 micropayments in USDC on Base or Solana. No API keys.","url":"https://readx.sh/api/lists/%7Bid%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZTG5iNsa0UGI-eVv3g6wS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches detailed JSON data for a specific X/Twitter list by its ID, including list metadata and members, paid per call via x402 micropayments.","exampleAgentPrompt":"Can you pull up the details for Twitter list ID 1234567890 — I want to know its name, description, and who owns it?","exampleUseCases":null,"resultDescription":"A JSON object containing list metadata such as list name, description, owner profile, member count, subscriber count, and other list-level attributes for the specified X/Twitter list ID.","failureModes":["Invalid or non-existent list ID returns an error code in the JSON response","List is private and not accessible returns an access error","Insufficient USDC balance or failed x402 payment results in HTTP 402 with no data returned","Malformed list ID format causes a bad request error","Rate limiting or temporary API unavailability returns a server error"],"whenToPreferThis":"Choose this endpoint when you need programmatic access to X/Twitter list data without managing Twitter API keys or OAuth credentials. Ideal for agents that need occasional, pay-as-you-go access to list metadata on X, especially when integrating with USDC-based micropayment workflows on Base or Solana. Prefer this over the official Twitter API when you want to avoid API key management and subscription tiers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T18:39:12.506Z","isFirstParty":false}