Stocktwits Scraper

📈 Stocktwits data for market research

Stocktwits Scraper helps traders, analysts, and researchers collect current public Stocktwits messages, user posts, and ranked trending symbols. It returns source sentiment, author and market context in structured dataset rows for market research and downstream analysis.

• Review author-supplied bullish and bearish labels for Stocktwits sentiment analysis.
• Use Stocktwits API to start Actor runs and download structured rows.
• Build a message dataset with Stocktwits dataset for text, symbols, authors, and dates.
• Collect current posts from public accounts with Stocktwits user posts.
• Export the ranked current symbol list with Stocktwits trending symbols.
• Review public author fields in message rows with Stocktwits author analysis.

📦 Stocktwits messages and trending symbols

Message rows contain message text, publication time, source sentiment, cashtags, mentions, public author fields, media, conversation details, and optional price-target fields. Trending-symbol rows contain ranked symbol identity, watchlist context, source trend fields, and market classification.

Some source values can be null or empty when Stocktwits does not provide them. When the same message is found through more than one symbol or username, the Actor saves the first eligible match and skips later matches. matchedInput shows the symbol or username that first found that saved message.

🚀 Run Stocktwits Scraper

1. Open the Input tab.
2. Choose symbol, user, trending, trending-streams, or trending-symbols in Result type.
3. Add ticker symbols or public usernames when the chosen mode needs them.
4. Set a work limit, or leave it empty to collect all available results until the relevant public source is exhausted.
5. Start the Actor and open the dataset.

A Stocktwits login or API key is not needed for this public data.

⚙️ Input

The selected mode controls which public rows the run requests. Fields for another mode are ignored.

Input fields

Field	Type	What it does
mode	string	Required. Choose symbol, user, trending, trending-streams, or trending-symbols. The form prefills symbol; the schema has no default for this field.
symbols	array of strings	Supplies Stocktwits ticker symbols for symbol mode. The schema default and form prefill are AAPL, TSLA, NVDA, SPY, and MSTR. Crypto symbols use the .X suffix, such as BTC.X or ETH.X.
usernames	array of strings	Supplies public Stocktwits usernames without the @ sign for user mode. The default is an empty list.
maxTrendingSymbols	integer, optional	Sets the number of ranked symbols for trending-symbols mode. Minimum 0. Leave it empty or set 0 to return all available results until the public trending source is exhausted.
maxMessagesPerTarget	integer, optional	Sets how many matching messages to read per symbol or user, or from the trending feed. A message counts toward each input's limit even if another input already saved it. Each message is saved only once. Minimum 0. The form prefills 9, but there is no schema default. Leave it empty or set 0 to return all available messages until the public feed is exhausted.
sentiment	string	For all message modes, choose all, bullish, or bearish to filter by the author's label. The default is all.
onlyPriceTargets	boolean	For all message modes, keeps only posts with a source-reported price target when true. The default is false.
newerThanMessageId	integer, optional	For all message modes, keeps messages with an ID greater than this Stocktwits message ID. Minimum 1. The named message is excluded. Leave it empty for no newer boundary.
olderThanMessageId	integer, optional	For all message modes, keeps messages with an ID less than this Stocktwits message ID. Minimum 1. The named message is excluded. Leave it empty for no older boundary.
includeAuthorReceivedLikes	boolean	For all message modes, adds the number of likes each message author got on their public posts when true. This is charged once per author in each run. The default is false, and both received-like fields are then null.
authorPostsForReceivedLikes	integer	Sets how many of each author's latest public posts to read when counting received likes. Used only when includeAuthorReceivedLikes is true. The default is 30. Set 0 to read all of the author's posts and get the full total, where available.

For both work limits, leaving the field empty or setting 0 returns all available results until the relevant source is exhausted.

Example input

This is the public input from a successful hosted QA default-input run on the current beta build:

{
  "mode": "symbol",
  "symbols": [
    "AAPL",
    "TSLA",
    "NVDA",
    "SPY",
    "MSTR"
  ],
  "usernames": [],
  "maxMessagesPerTarget": 9,
  "sentiment": "all",
  "onlyPriceTargets": false,
  "includeAuthorReceivedLikes": false,
  "authorPostsForReceivedLikes": 30
}

🧾 Output

Output fields

Each dataset row is either a message or a trending symbol.

Message rows

Field	Type	What it does
recordType	string	Identifies a message row as message.
messageId	integer or null	Stocktwits message ID.
matchedInput	string or null	Symbol or username that first found the message.
body	string or null	Full message text with HTML character codes decoded once. If Stocktwits sends a code that is encoded twice, such as &, the row keeps one layer, such as &.
createdAt	date-time string or null	Time the message was posted in ISO 8601 format.
sourceSentiment	string or null	Stocktwits Bullish or Bearish label, or null when none is present.
postingSource	string or null	App used to post the message, as reported by Stocktwits.
reshares	integer or null	Number of message reshares reported by Stocktwits.
cashtags	object[]	Cashtags found in the message.
cashtags[].symbol	string or null	Cashtag symbol.
cashtags[].title	string or null	Company or asset name.
cashtags[].exchange	string or null	Exchange name.
cashtags[].watchlistCount	integer or null	Stocktwits watchlist count for the cashtag.
cashtags[].currentPrice	number or null	Price shown with the message.
mentions	string[]	Stocktwits usernames named in the message.
author	object or null	Public facts about the author.
author.username	string or null	Author username.
author.name	string or null	Author display name.
author.avatarUrl	string or null	Author profile image URL.
author.official	boolean or null	Whether Stocktwits marks the author as official.
author.followers	integer or null	Author follower count.
author.following	integer or null	Number of accounts the author follows.
author.ideas	integer or null	Author idea count shown by Stocktwits.
author.likes	integer or null	Number of posts the author has liked.
author.receivedLikes	integer or null	Likes received on the author's latest public posts, up to the authorPostsForReceivedLikes count. This may be a sample. Null when includeAuthorReceivedLikes is off or the count is unavailable.
author.receivedLikesTotal	integer or null	Full received-like total. Available only when all of the author's public posts were read and the unique post count matches Stocktwits. Otherwise null.
author.watchlistCount	integer or null	Number of symbols on the author's watchlist.
author.joinedAt	string or null	Date the author joined Stocktwits.
media	object[]	Media attached to the message.
media[].type	string or null	Media type.
media[].url	string or null	Media URL.
media[].width	integer or null	Media width in pixels.
media[].height	integer or null	Media height in pixels.
chartUrl	string or null	Link to a chart attached to the message.
likes	integer or null	Number of likes on the message.
conversation	object or null	Reply details from Stocktwits.
conversation.parentMessageId	integer or null	Parent message ID.
conversation.inReplyToMessageId	integer or null	Message ID this post replies to.
conversation.replies	integer or null	Reply count.
conversation.isParent	boolean or null	Whether this is a parent message.
priceTarget	object or null	Price-target details from Stocktwits when present.
priceTarget.price	number or null	Target price.
priceTarget.currency	string or null	Target currency.
priceTarget.date	string or null	Target date.
priceTarget.startingPrice	number or null	Starting price for the target.
priceTarget.currentPrice	number or null	Current price shown for the target.
priceTarget.startDate	string or null	Start date of the source-reported price prediction.
priceTarget.status	string or null	Prediction status reported by Stocktwits, such as active or completed.
priceTarget.isHit	boolean or null	Whether the target was hit, as reported by Stocktwits.
priceTarget.finalPrice	number or null	Final price for the prediction, as reported by Stocktwits.
priceTarget.targetAccuracy	number or null	Target accuracy value reported by Stocktwits. The Actor does not calculate it.

Genuine message row

This genuine row is from a successful run on the current beta build:

{
  "recordType": "message",
  "messageId": 667979647,
  "matchedInput": "TSLA",
  "body": "$TSLA",
  "createdAt": "2026-11-02T23:55:03Z",
  "sourceSentiment": "Bearish",
  "postingSource": "StockTwits for iOS",
  "reshares": null,
  "cashtags": [
    {
      "symbol": "TSLA",
      "title": "Tesla Inc",
      "exchange": "NASDAQ",
      "watchlistCount": 1071863,
      "currentPrice": 404.52
    }
  ],
  "mentions": [],
  "author": {
    "username": "Ermergerd",
    "name": "Impeccablly Unique Insights",
    "avatarUrl": "https://avatars.stocktwits.com/production/10621193/thumb-1761331197.png",
    "official": false,
    "followers": 34,
    "ideas": 1165,
    "following": 27,
    "likes": 2854,
    "watchlistCount": 32,
    "joinedAt": "2025-10-24",
    "receivedLikes": null,
    "receivedLikesTotal": null
  },
  "media": [
    {
      "type": "gif",
      "url": "https://media2.giphy.com/media/3o85xHi4t2UsuIY9QA/giphy.gif",
      "width": 480,
      "height": 271
    }
  ],
  "chartUrl": null,
  "likes": 8,
  "conversation": {
    "parentMessageId": 667979647,
    "inReplyToMessageId": null,
    "replies": 1,
    "isParent": true
  },
  "priceTarget": {
    "price": 350,
    "currency": "USD",
    "date": "2026-11-06T16:00:00-05:00",
    "startingPrice": 404.52,
    "currentPrice": 404.05,
    "startDate": "2026-11-02T18:55:03-05:00",
    "status": "active",
    "isHit": null,
    "finalPrice": null,
    "targetAccuracy": null
  }
}

Trending-symbol rows

Field	Type	What it does
recordType	string	Identifies a trending-symbol row as trendingSymbol.
rank	integer or null	Trending rank, starting at one.
symbol	string or null	Trending Stocktwits symbol.
title	string or null	Company or asset name.
exchange	string or null	Exchange name.
region	string or null	Region code.
instrumentClass	string or null	Type of market item.
logoUrl	string or null	Symbol logo image URL.
watchlistCount	integer or null	Stocktwits watchlist count.
sentimentChange	number or null	Sentiment change supplied by Stocktwits.
volumeChange	number or null	Discussion-volume change supplied by Stocktwits.
trendScore	number or null	Trend score supplied by Stocktwits.
trendSummary	string or null	Trend summary supplied by Stocktwits.
sector	string or null	Market sector.
industry	string or null	Market industry.
marketCap	number or null	Market value of the company or asset in US dollars.

Genuine trending-symbol row

This genuine row is from a successful trending-symbols run on the current beta build:

{
  "recordType": "trendingSymbol",
  "rank": 1,
  "symbol": "PLTR",
  "title": "Palantir Technologies Inc",
  "exchange": "NASDAQ",
  "region": "US",
  "instrumentClass": "Stock",
  "logoUrl": "https://logos.stocktwits-cdn.com/PLTR.png",
  "watchlistCount": 325800,
  "sentimentChange": -5.58,
  "volumeChange": 128.96,
  "trendScore": 13.9625,
  "trendSummary": "Palantirs quarterly results beat expectations and lifted its outlook, with rapid U.S. commercial AI growth overtaking government revenue for the first time. The shares nevertheless fell, as traders debated whether strong growth was already priced in given the companys high valuation, while others viewed the selloff as a disconnect from the results.",
  "sector": "TechnologyServices",
  "industry": "PackagedSoftware",
  "marketCap": 442427062459
}

💳 Pricing

This Actor uses pay-per-event pricing. A charge applies when one public message or trending symbol is saved to your dataset. When includeAuthorReceivedLikes is on, a second charge applies once per author in each run when that author's received-like count is added to a saved message. The current rates are shown in the pricing panel.

🔌 Integrations

• Run the Actor through the Apify API from Python or JavaScript.
• Set an Apify schedule for repeat runs.
• Export the dataset as JSON, CSV, or Excel.
• Use Apify webhooks to send run events to another service.

❓ FAQ

What happens when I leave a work limit empty?

The Actor returns all available messages or trending symbols until the relevant public source is exhausted.

What does matchedInput mean?

It is the first symbol or username that found a saved message. If another value finds the same message later, that later match is skipped. Trending messages have null because they are not tied to a symbol or username.

What happens when Stocktwits leaves out a value?

The field can be null or empty. The Actor does not invent missing source facts.

Does source sentiment appear on every message?

No. sourceSentiment is present when the author added a Bullish or Bearish label. It is null when no label is present. The Actor does not score message text.

Can I collect posts from a Stocktwits user?

Yes. Choose user and enter public usernames without the @ sign.

Which mode should I choose?

Use symbol for current public messages for submitted tickers, user for current public posts from submitted usernames, trending for current market-wide trending messages, trending-streams for recent messages from trending tickers, and trending-symbols for the ranked public trending-symbol list.

Does this provide a full Stocktwits archive?

No. It collects current public data exposed by the chosen Stocktwits source. It does not promise a full historical archive.

Is the data a trading recommendation?

No. The Actor returns source data, including author-supplied sentiment labels. It does not give trading advice or predict prices.

📝 Changelog

v4.0 (02-11-2026)

• Author received likes are now off by default, because each author's count costs extra reads and is now charged once per author. Runs that leave includeAuthorReceivedLikes unset now return null for author.receivedLikes and author.receivedLikesTotal. To keep these counts, set includeAuthorReceivedLikes to true. Use authorPostsForReceivedLikes to choose how many posts per author to count.
• Message text now decodes each HTML character code only once, so text such as < stays as <.
• Reliability improvements.

v3.0 (25-10-2026)

• Removed computedSentiment and sentimentScore because the text labels and scores could be wrong. There is no replacement text score or label. Remove these keys from your code and analyze body separately if you need text sentiment. sourceSentiment still gives the author's Bullish or Bearish label when present.
• Set includeAuthorReceivedLikes to false to skip author received-like counts and the extra author post reads. Both author.receivedLikes and author.receivedLikesTotal are then null.
• Set maxMessagesPerTarget or maxTrendingSymbols to 0 to collect all available results, just as when the limit is empty.
• Price targets now include priceTarget.status, priceTarget.isHit, priceTarget.finalPrice, and priceTarget.targetAccuracy when Stocktwits provides them. These values describe the source-reported prediction outcome.
• Trending-symbol rows now try to include available sentiment-change and volume-change values for every ranked symbol. These fields stay null when the values are unavailable.
• Reliability improvements.

v2.1 (20-10-2026)

• Message rows now include likes received on a sample of each author's public posts. Use authorPostsForReceivedLikes to set the sample size. author.receivedLikesTotal stays null unless all public posts were read and their count matches Stocktwits.
• Symbol searches with newerThanMessageId now continue to later available messages instead of stopping after the first message window.
• Saved-message logs now name the symbol or username in matchedInput when one is present.
• Message text now decodes HTML character codes.
• Cashtag lists now include tags written back to back.
• Mentioned usernames now omit the leading @.
• GIF entries now include a media link when Stocktwits supplies a supported GIF ID.
• Trending-symbol market caps now use US dollars for all instrument types. Unavailable sector and industry values reported as 0 now use null.

v2.0 (09-10-2026)

• Removed messageUrl, which was a link built from the username and message ID rather than a link returned by Stocktwits. There is no replacement link field. Remove this key from code that reads message rows.
• Collect recent messages from trending tickers with trending-streams.
• Filter messages by trader sentiment, price targets, or message ID range.
• Message rows now include a text sentiment score, posting app, and reshare count.
• Text sentiment is always included. The includeComputedSentiment input was removed, so includeComputedSentiment: false no longer turns it off. Remove this input from saved run settings.
• Price targets now include their source start date and use the source-reported prediction currency when available.
• The paid result label now covers both messages and trending symbols.

v1.1 (22-09-2026)

• Collect trending messages and ranked trending symbols with richer market details.
• Save richer message rows with author, media, conversation, price target, and sentiment data.
• Leave source limits empty to collect all available results.
• Reliability improvements.

v1.0

• Added message rows, computed sentiment, author and market context, and ranked trending-symbol details.

v0.0

• Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• Text Sentiment Analysis. Apply positive, neutral, or negative labels to message text for follow-up analysis.
• Twitter Scraper. Add public X posts and profile context when Stocktwits is one part of market research.
• Reddit Comments Search Scraper. Compare public Reddit comments with Stocktwits discussion for sentiment work.
• Morningstar Fund & ETF Scraper. Add public stock, mutual fund, and ETF research to symbol-level market work.
• Barchart Scraper. Add financial news, quotes, and options data for the same symbols.

Made with ❤️ by Maxime Dupré