Stocktwits Scraper

Stocktwits Scraper exports public ticker-stream messages with text, author details, bullish or bearish labels, engagement counts and source links. Use the Stocktwits data in watchlist research, market-discussion dashboards or your own analysis workflow.

It collects messages for known ticker symbols. It does not search company names, predict prices or calculate sentiment from message text.

Quick start

Enter a small watchlist in Stocktwits symbols, choose a message limit and click Start. Open the dataset when the run finishes.

{
  "symbols": ["AAPL", "TSLA"],
  "maxMessagesPerSymbol": 20
}

Use Stocktwits ticker symbols, not page URLs. Available public history can be shorter than the requested limit.

Prefer a video guide? This short Apify walkthrough shows you how to set up and run an Actor. It uses a different Actor, but the setup steps are the same.

Ready-to-run examples

Choose an example to start with a preconfigured input:

• Track Stocktwits sentiment for AAPL, TSLA, NVDA, and MSFT — Collect up to 25 recent messages per ticker with the source's sentiment labels.
• Export Stocktwits messages for BTC, ETH, and COIN — Collect up to 20 messages each for BTC.X, ETH.X, COIN and MSTR.

What you get

• Message-level records: cleaned message text, IDs, timestamps and direct links.
• Public author details: available user IDs, handles, display names and avatars.
• Source sentiment and engagement: bullish/bearish labels where supplied, likes and replies.
• Cashtags and optional original JSON: mentioned symbols alongside normalized fields.
• Collection boundaries: message-ID inputs for newer or older content.

Who is it for?

• Market researchers comparing public discussions across a watchlist.
• Data teams combining messages with market data or news.
• Social-listening teams reviewing company mentions and recurring themes.
• Researchers studying trader language and source-provided sentiment labels.

Input settings

Setting	API key	Meaning
Stocktwits symbols	symbols	Required list, such as AAPL, $TSLA or BTC.X.
Messages per symbol	maxMessagesPerSymbol	Maximum saved per ticker, 1–1,000. Default 20.
Since message ID	sinceMessageId	Request messages newer than a known ID, when supported.
Continue when a symbol fails	continueOnError	Try other symbols after a source error. Default false.
Before message ID	beforeMessageId	Begin before a known message ID for older content.
Include raw message JSON	includeRaw	Add the original message object. Default false.
Proxy configuration	proxyConfiguration	Optional explicit connection settings. Disabled by default.

Symbols are trimmed, uppercased and deduplicated. A leading $ is removed. Use letters, numbers, dots, hyphens or underscores, up to 20 characters.

Collect more messages or original JSON

{
  "symbols": ["NVDA"],
  "maxMessagesPerSymbol": 100,
  "includeRaw": true
}

Continue across a watchlist

{
  "symbols": ["AAPL", "MSFT", "TSLA"],
  "maxMessagesPerSymbol": 50,
  "continueOnError": true
}

Use a saved message ID with sinceMessageId for newer-message collection or beforeMessageId for older content. These boundaries apply to every requested symbol. Use separate runs when each symbol needs a different boundary.

Output data

Each dataset row represents one public message from the requested symbol stream.

Fields	Meaning
symbol, messageId	Requested normalized symbol and message identifier.
body, createdAt	Cleaned text and available timestamp.
userId, username, userName, avatarUrl	Available public author details. Missing values are null.
sentiment	Source label: bullish, bearish or null.
likes, replies	Engagement counts, defaulting to zero when absent.
mentionedSymbols	List of mentioned ticker symbols.
sourceUrl	Message link derived from the author handle and ID.
raw	Original message JSON, only when requested.

Illustrative shape only, not a collected message:

{
  "symbol": "AAPL",
  "messageId": 1,
  "body": "Illustrative message text",
  "createdAt": null,
  "userId": null,
  "username": null,
  "userName": null,
  "avatarUrl": null,
  "sentiment": null,
  "likes": 0,
  "replies": 0,
  "mentionedSymbols": ["AAPL"],
  "sourceUrl": "https://stocktwits.com/message/message/1"
}

The Run summary output links to RUN_SUMMARY, which reports saved-message totals, completed, failed and pending symbols and the run status. A partial run can have useful dataset rows without completing the entire watchlist. PENDING_WORK, when present, supports recovery after an interrupted collection.

Download your results

Open your run's dataset, choose Export and select JSON, CSV or Excel. JSON keeps nested fields together. CSV and Excel are useful when you want to review the records in a spreadsheet.

See Apify's download and export guide for the available formats and field options.

Pricing

This Actor uses pay-per-event pricing. run-started is charged once after input validation and connection setup, including runs that later return no matching messages.

message-scraped is charged for each message saved to the dataset. Empty streams and summary records do not create message-result charges. A message appearing in more than one requested symbol stream can produce a row for each stream.

See the live Pricing tab for current rates and discounts.

Tips for best results

• Start with a small watchlist. Check a few tickers before expanding the collection.
• Keep message limits focused. The maximum is an upper bound, not a promise of available history.
• Save message IDs. Use them as boundaries for later collections and deduplicate in your workflow.
• Inspect the run summary. Partial output may omit failed or pending symbols.
• Request raw JSON only when useful. Normalized fields are easier to use in spreadsheets.

Limits and caveats

Only public symbol streams are supported. Private content, account inboxes, user-profile streams, trending discovery and full historical archives are not included. Availability depends on Stocktwits and can change.

Sentiment is the label supplied with a message, not a new AI assessment. An unlabeled message has null sentiment. A generated source link may not resolve when the author handle is unavailable or a post is removed.

A valid stream with no matching messages completes with an empty dataset. An explicit Stocktwits “Symbol not found” response also completes without message rows, with a warning and a per-symbol reason in RUN_SUMMARY.unavailableSymbols. Other symbols are still collected, regardless of continueOnError. This does not treat blocking, unknown responses or request failures as empty results. Request failures with no saved messages can fail the run. When a later source error occurs with continueOnError disabled, previously saved rows remain available and remaining work is recorded. Enabling it lets other symbols continue, but does not guarantee complete results.

This is an independent tool and is not affiliated with Stocktwits. Messages are discussion data, not investment advice.

Automation and integrations

Save your settings for next time

Once you have an input that works for you, save it as an Apify task. This keeps your settings together so you can use them again without filling in the form from scratch.

Run on a schedule

Need fresh results regularly? You can schedule the Actor or a saved task to run at a time that suits you.

Each scheduled run collects the data again. If you want to compare results or highlight changes, add that step in your own workflow.

Send results to your other tools

Use n8n, Make or Zapier to connect this scraper to the rest of your workflow. For example, you could pass its results to an AI assistant or add records to a spreadsheet. Follow the Apify integration guides for your chosen tool.

For a custom connection, an Apify webhook can notify your app when a run finishes or fails. Your app can then fetch the results or handle the failure.

API usage

Want to collect this data from your own app or automation? The examples below send input to the scraper and show how to collect its results.

The Node.js and Python examples wait for the run to finish before reading its results. The cURL example starts the run and returns its details. Wait for that run to finish, then use its defaultDatasetId to fetch the results.

For setup instructions, see Apify's JavaScript client guide, Python client guide and Actor runs API reference.

cURL

curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~stocktwits-scraper/runs' \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"symbols":["AAPL","TSLA"],"maxMessagesPerSymbol":20}'

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/stocktwits-scraper').call({
  symbols: ['AAPL', 'TSLA'],
  maxMessagesPerSymbol: 20,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/stocktwits-scraper').call(run_input={
    'symbols': ['AAPL', 'TSLA'],
    'maxMessagesPerSymbol': 20,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

MCP and AI agents

You can ask your AI assistant to collect data with Stocktwits Scraper and help you work with the results. The scraper returns the data, and your assistant can then summarize it, compare records or prepare notes.

Connect your assistant through the Apify MCP server. MCP gives your assistant a way to find this scraper, run it and read the results. Follow the official setup and sign-in guide for your app.

Easier setup with an Apify plugin

If you use a supported coding assistant, the official Apify plugin can set up the connection for you. It connects your assistant to Apify and includes instructions for common tasks. Follow the guide for your particular app.

Use Apify AI in Console

Prefer to keep everything in Apify? Open Apify AI in Console and ask it to find Fetch Cat's Stocktwits Scraper. You can describe the data you want and ask questions about the results.

Apify AI is currently in beta. It asks for confirmation before starting an Actor, and normal run charges apply.

Choose your assistant

• Claude and Claude Code (Anthropic): Apify setup guide.
• ChatGPT and Codex (OpenAI): Apify setup guides.
• Grok Bot (xAI): Apify plugin guide.
• Gemini CLI (Google): MCP server setup guide. Use the server URL below with the HTTP configuration supported by Gemini CLI.

Connect just this scraper

To keep your setup focused on this scraper, add this server configuration to a compatible MCP client:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=fetch_cat/stocktwits-scraper"
    }
  }
}

Sign in to Apify when your client asks. If your client uses a Bearer token instead, follow its setup guide and keep the token in its secure configuration. Configuration formats vary by app, so use the linked guide if your client needs a different format.

Use Apify's general server

Already connected to the general Apify MCP server at https://mcp.apify.com? You can use it to find this scraper without adding another server. Ask your assistant to use Stocktwits Scraper by Fetch Cat, or give it the identifier fetch_cat/stocktwits-scraper.

Your assistant can check the available settings and retrieve the results from the returned run. If the run is still working, it should follow that run rather than start it again. Both connection options use Apify's hosted service.

Example requests

• "Get recent public messages about Apple and Tesla, then summarize the main discussion themes."
• "Collect NVIDIA's latest ticker messages and compare the bullish and bearish labels supplied by the authors."
• "Collect recent messages for Bitcoin and Ethereum using their Stocktwits symbols, then prepare a table of message links and engagement counts."

Normal Apify charges apply. Check the live Pricing tab before asking your assistant to run a larger batch.

Pay with x402

If your AI agent has a funded wallet, it can pay for Apify usage through x402. This experimental option lets an agent use Apify without a conventional account.

Apify AGI provides a prepaid API token with a spending cap after payment. Your agent can use that token to run this scraper through the Apify API or an authenticated MCP connection.

Some MCP setups also support paying for each request directly. That is a different payment option, so check the official guide for its availability.

Follow the official guide for wallet setup, supported payment options and current terms. Apify handles the payments. Keep wallet keys and payment tokens in your agent's secure configuration.

Other ways for agents to pay

Apify also supports MPP for prepaid access through AGI and Skyfire for eligible Actors. If your agent already uses one of these, see the agentic payment guide to choose the right setup.

FAQ

Can I use this as a Stocktwits API alternative?

You can call the Actor through Apify's API to collect public ticker-stream messages. It is not an official Stocktwits API and does not cover every Stocktwits feature.

Can I export Stocktwits data to CSV or JSON?

Yes. Export the dataset as JSON, CSV or Excel, or fetch it through the Apify API. JSON is best when you include nested raw messages.

Does it calculate market sentiment?

No. It returns the bullish or bearish label already attached to a message when one is supplied. You can calculate aggregates or perform your own text analysis afterward.

Does it fetch every historical message?

No. Message boundaries help collect accessible older or newer messages, but source availability limits coverage. The requested message limit is not a guarantee.

Does it require a proxy?

No. Direct access is the default. Optional connection settings are explained in the input form. A failed direct request does not automatically enable a paid route.

Can I use it with an AI assistant?

Yes, through the Apify API or the supported MCP setup above. Ask the assistant to use bounded inputs and read the returned dataset before summarizing it.

Related Actors

• Yahoo Finance Stock & OHLCV Data Scraper — Add price and market-history context.
• Google News Scraper — Collect relevant headlines.
• Reddit Scraper — Review broader public discussions.
• Reddit Post Monitor & Keyword Scraper — Collect recent matching public Reddit posts, with optional cross-run history to exclude previously discovered IDs.
• Hacker News Search Scraper — Find technology and company discussions.

Support and feedback

For custom additions or integrations, email hello@fetchcat.dev.

Found an error or have a feature request? Open an issue with the run URL, a non-sensitive input example and what you expected.

Need help sharing it? See Apify’s guide to sharing a run when reporting an issue. Sharing a run can give the developer access to its input, logs and results, so use a run that contains no sensitive data. Please leave out API tokens, passwords, cookies, private documents and personal data. Use a public sample URL or a redacted example instead.

Tried this scraper? We'd love to hear how it worked for you. Leave a review to help others choose the right tool and help us improve it. Your feedback means a lot to us.

Made with care for curious people, AI agents and the possibilities in data. ♥