List Scraper

Collect posts from any X list and turn curated sources into a reliable feed for monitoring, research, and recurring reporting.

About SIMO IT

SIMO IT helps teams operationalize social data through focused scraping agents and automation-first workflows.

Features

• collect tweets from a selected X list
• monitor groups of experts, media, or competitors in one stream
• run recurring insight collection with no manual effort
• paginate results to expand data coverage

Use cases

• daily industry monitoring
• topic list tracking (AI, fintech, e-commerce, and more)
• fast discovery of emerging market signals

Output

A ready-to-analyze set of list tweets that can feed reports, alerts, and automated workflows.

Note: backend endpoint returns an envelope: { data: [...], page, limit, has_next }. This Actor pushes only tweet objects from data[] to the dataset.

How to use

1. Open the Actor on Apify.
2. Provide listId or listUrl (or batch via listIds / listUrls).
3. Configure pagination as needed.
4. Run the Actor and process dataset output.

No technical setup is required from your side. Backend infrastructure is managed by SIMO IT.

Input

• listId (string, conditionally required): X list ID. Pass it as text, not a number, because large IDs exceed the JavaScript safe integer range.
• listIds (string, optional): Batch list IDs (comma-separated or new lines).
• listUrl (string, optional): Single X/Twitter list URL.
• listUrls (string, optional): Batch list URLs (comma-separated or new lines).
• page (integer, optional, default: 1): Starting page number.
• limit (integer, optional, default: 20, max: 100): Records per page.
• maxPages (integer, optional, default: 1): Maximum number of pages to fetch.
• maxItems (integer, optional): Hard cap for total output records.

Filters and pagination

• list target: listId, listIds, listUrl, listUrls
• page controls: page, limit, maxPages, maxItems

Example input

{
  "listId": "1320855175175852034",
  "limit": 20,
  "maxItems": 100
}

{
  "listUrls": "https://x.com/i/lists/1234567890123456789",
  "limit": 20,
  "maxItems": 100
}

Example output

{
  "id": 2026275002270523820,
  "id_str": "2026275002270523820",
  "url": "https://x.com/krakow_pl/status/2026275002270523820",
  "date": "2026-02-24T12:36:21+00:00",
  "user": {
    "id": 78260767,
    "id_str": "78260767",
    "url": "https://x.com/krakow_pl",
    "username": "krakow_pl",
    "displayname": "Kraków",
    "verified": false
  },
  "lang": "pl",
  "rawContent": "#Krakow ...",
  "replyCount": 0,
  "retweetCount": 0,
  "likeCount": 1,
  "quoteCount": 0,
  "bookmarkedCount": 0,
  "conversationId": 2026275002270523820,
  "conversationIdStr": "2026275002270523820",
  "hashtags": ["Krakow", "zlobki"],
  "cashtags": [],
  "mentionedUsers": [],
  "links": [
    {
      "url": "http://m.in",
      "text": "m.in",
      "tcourl": "https://t.co/iCphpaUt9t"
    }
  ],
  "media": {
    "photos": [{ "url": "https://pbs.twimg.com/media/HB7GGGhWAAA2LGp.jpg" }],
    "videos": [],
    "animated": []
  },
  "viewCount": 162,
  "retweetedTweet": null,
  "quotedTweet": null,
  "place": null,
  "coordinates": null,
  "inReplyToTweetId": null,
  "inReplyToTweetIdStr": null,
  "inReplyToUser": null,
  "source": null,
  "sourceUrl": null,
  "sourceLabel": null,
  "card": null,
  "possibly_sensitive": false,
  "_type": "snscrape.modules.twitter.Tweet"
}

FAQ

Do I need my own backend or API setup?
No. This Actor is ready to run on Apify, and backend infrastructure is managed by SIMO IT.

Where do I get listId?
Use the X list ID from the list URL or your list management workflow, and pass it as a string.

Can I collect larger list datasets?
Yes. Increase maxPages and tune limit to fetch more results.