Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
No output yet. Submit the form to generate content.
Transparent pricing with no hidden fees. Pay as you go.
| Rule & Modality | Channel | Credits | Price (USD) | Official / Reference Price | Daily Savings |
|---|---|---|---|---|---|
list-latest-tweets-timeline otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
Competitor pricing costs $45.450 more
ApiPass is 90.90% lower, estimated at multiple calls returning 10,000 returned posts total
list-latest-tweets-timeline
ApiPass Price
$0.0005
0.1 credits per post
Competitor Prices
Complete guide to using twitter-api-graphql
Retrieve the latest tweet timeline from any public Twitter List in a single GraphQL-powered API call.
The Twitter Graphql List Latest Tweets Timeline API on ApiPass is a managed endpoint that lets developers fetch the most recent tweets posted by members of a specific Twitter (X) List, identified by its unique listId. Built on top of Twitter's internal GraphQL infrastructure and exposed through ApiPass's unified createTask / recordInfo task pipeline, the API returns a structured JSON timeline containing tweet objects, author metadata, engagement metrics, and media attachments. Instead of dealing with Twitter's authentication flow, rate limits, or undocumented GraphQL parameters directly, you simply submit a task with your target listId, optional count, and includePromotedContent flag, then poll or receive a webhook callback once the timeline data is ready.
Skip Twitter's lengthy application review, project approval, and elevated-access gates. Authenticate with a single ApiPass API key and start pulling list timelines immediately.
The endpoint follows a create-task-then-fetch-result pattern, returning a taskId instantly so your application never blocks on long-running scrapes. Results are delivered via recordInfo polling or an optional callBackUrl webhook.
ApiPass automatically allocates each request across starter, regular, and official providers based on real-time pricing and stability metrics, balancing minimal cost with reliable performance — no manual failover code required.
Avoid Twitter's expensive monthly Basic/Pro/Enterprise tiers. You only pay for the list-timeline tasks you actually run, making it cost-effective for both prototypes and production workloads.
The response is wrapped in a consistent resultJson.resultObject.data.list.tweets_timeline structure, identical to Twitter's GraphQL schema, so you can integrate without writing custom HTML/HAR parsers.
Every task exposes lifecycle states (waiting, queuing, generating, success, fail) along with createTime, completeTime, and costTime fields, giving you full observability into request performance.
Use the optional count parameter (e.g., 20) to control how many tweets are returned per call, balancing freshness against payload size for your use case.
Toggle includePromotedContent: false to exclude sponsored/promoted tweets and receive a clean stream of organic posts authored by list members only.
Provide a callBackUrl when creating the task and ApiPass will POST the completed timeline directly to your endpoint, eliminating the need to poll for completion.
Pull tweets from journalist or industry-expert Lists to power a real-time news feed inside your own product or newsletter.
Monitor competitor or influencer Lists and surface mentions, hashtags, and trends as they happen.
Build Slack, Discord, or Telegram bots that broadcast the latest tweets from a private team-curated List to keep stakeholders informed.
Continuously harvest topic-specific List timelines to assemble high-signal corpora for LLM fine-tuning, sentiment analysis, or academic research.
See how ApiPass simplifies access, pricing, and integration compared to Twitter's official List timeline endpoint.
Twitter's official GET /2/lists/:id/tweets endpoint requires a paid Developer Portal subscription, project creation, and OAuth 2.0 setup before the first call. ApiPass replaces all of this with a single bearer token and a model field set to twitter/graphql/list-latest-tweets-timeline — you can be live in minutes rather than days.
Twitter's official tiers impose strict monthly post caps and tiered pricing that can scale into thousands of dollars per month. ApiPass uses a per-task pay-as-you-go model with intelligent provider routing (auto channel), so costs scale linearly with usage and there are no minimum commitments or surprise overage fees.
Watch curated Lists of traders, analysts, or protocol founders to detect market-moving tweets the moment they're published.Watch curated Lists of traders, analysts, or protocol founders to detect market-moving tweets the moment they're published.
Track Lists of customers, partners, or critics to capture mentions of your brand or product in near real-time.
Mirror the latest posts from an editorial List into a CMS, blog sidebar, or mobile app feed without manual copy-paste.
Aggregate tweets from a List of competitor accounts and run downstream NLP to track product launches, hiring announcements, or PR campaigns.
Sign up on ApiPass, navigate to the dashboard, and generate a bearer token. No Twitter Developer account or OAuth handshake is needed — your ApiPass key is the only credential required to authenticate every request.
Send a POST request to /api/v1/jobs/createTask with the model set to twitter/graphql/list-latest-tweets-timeline and your target listId inside the input.variables object. You can also include optional parameters such as count to limit how many tweets are returned, includePromotedContent to filter out sponsored posts, and callBackUrl if you'd like the result delivered via webhook. ApiPass will respond immediately with a taskId you can use to track the job.
Either wait for ApiPass to push the completed timeline to your callBackUrl, or poll GET /api/v1/jobs/recordInfo with your taskId. Once the task state transitions to success, the full list timeline will be available under data.resultJson.resultObject.data.list.tweets_timeline, ready to parse and integrate into your application.
All APIs require authentication via Bearer Token.
Authorization: Bearer
Get the List's latest tweet timeline.
The API accepts a JSON payload with the following structure:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "listId": "string",
8 "count": "number",
9 "includePromotedContent": "boolean",
10 }
11 }
12}modelRequiredstringThe model name to use for generation
"twitter/graphql/list-latest-tweets-timeline"
callBackUrlOptionalstringCallback URL for task completion notifications. If omitted, no callback will be sent.
"https://your-domain.com/api/callback"
channelOptionalstringYou may specify the corresponding provider within APIPASS via the channel parameter; these providers handle the actual image and video generation tasks. APIPASS currently offers three provider options:
The default value for the channel parameter is auto. When enabled, APIPASS automatically allocates tasks across available providers based on real-time pricing and stability metrics to balance minimal cost and reliable performance. Retain the default auto value unless you have custom routing requirements.
Available options:
auto
The input object contains the following parameters:
input.variables.listIdRequiredstring44196397
input.variables.countOptionalnumber20
input.variables.includePromotedContentOptionalbooleanfalse
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "twitter/graphql/list-latest-tweets-timeline",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "listId": "123",
10 "count": 20,
11 "includePromotedContent": false,
12 }
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}codeStatus code, 200 for success, others for failure
messageResponse message, error description when failed
data.taskIdTask ID for querying task status and results
