Stocktwits Sentiment Scraper

Extract Stocktwits market sentiment data in minutes. Collect trending symbols and market messages at scale, enriched with sentiment labels for faster analysis. Built for traders, research teams, and automation workflows that need reliable sentiment datasets.

Features

• Trending symbol tracking — Collect symbols gaining the most attention right now
• Market message extraction — Gather fresh market-focused messages from active symbol streams
• Sentiment labeling — Add positive, neutral, or negative labels for quick signal analysis
• Flexible volume control — Set custom limits for symbols and news items in each run
• Run summary output — Save a structured execution summary for downstream automation

Use Cases

Trading Signal Research

Build historical sentiment datasets to evaluate how crowd tone aligns with price movement. Compare trend shifts and sentiment spikes across symbols and sessions.

Market Intelligence Dashboards

Feed near-real-time buzz and sentiment into internal dashboards. Track what the community is discussing and which topics are gaining momentum.

Alerting and Workflow Automation

Trigger alerts when new sentiment-tagged messages appear. Route data to webhooks, spreadsheets, or analytics tools for automated monitoring.

Content and Narrative Analysis

Measure how market narratives evolve during major events like earnings, macro releases, or sector rotations. Identify which stories drive the most engagement.

---

Input Parameters

Parameter	Type	Required	Default	Description
includeTrendingSymbols	Boolean	No	true	Include trending symbols in output
maxSymbols	Integer	No	20	Maximum number of trending symbols to collect
includeNews	Boolean	No	true	Include Stocktwits market messages
maxNewsItems	Integer	No	20	Maximum number of news messages to collect
computeSentiment	Boolean	No	true	Add sentimentScore and sentimentLabel fields
timeoutSecs	Integer	No	30	Request timeout per source endpoint
maxRetries	Integer	No	3	Maximum retry attempts per request
proxyConfiguration	Object	No	—	Optional proxy settings for improved reliability

---

Output Data

Each dataset item contains one of these record types: trending_symbol, news_message, or error.

Field	Type	Description
type	String	Record type (trending_symbol, news_message, error)
fetchedAt	String	Timestamp when the record was collected
sourceUrl	String	Source URL tied to the record
rank	Number	Rank among trending symbols (trending only)
symbol	String	Ticker symbol (trending only)
title	String	Symbol title (trending only)
id	Number	Symbol identifier (trending only)
watchlist_count	Number	Watchlist count when available (trending only)
messageId	Number	News message ID (news only)
createdAt	String	Original message timestamp (news only)
symbol	String	Primary symbol associated with the message (news only)
body	String	News message text (news only)
user	Object	Author info with id and username (news only)
likes	Number	Message like count when available (news only)
sentimentScore	Number	Numeric sentiment score (news only, if enabled)
sentimentLabel	String	Sentiment label from score (positive, neutral, negative)
raw	Object	Raw source payload for full downstream flexibility
endpoint	String	Endpoint that failed (error only)
error	String	Error message when extraction fails (error only)

A run summary is stored in key-value store record OUTPUT.

---

Usage Examples

Basic Run

{
  "includeTrendingSymbols": true,
  "maxSymbols": 20,
  "includeNews": true,
  "maxNewsItems": 20,
  "computeSentiment": true
}

Trending Symbols Only

{
  "includeTrendingSymbols": true,
  "maxSymbols": 50,
  "includeNews": false
}

News-Only Collection Without Sentiment

{
  "includeTrendingSymbols": false,
  "includeNews": true,
  "maxNewsItems": 100,
  "computeSentiment": false
}

---

Sample Output

{
  "type": "news_message",
  "fetchedAt": "2026-02-24T12:00:00.000Z",
  "messageId": 123456789,
  "createdAt": "2026-02-24T11:59:10Z",
  "symbol": "NVDA",
  "body": "Strong reaction to earnings guidance in tech this morning.",
  "user": {
    "id": 987654,
    "username": "marketwatcher"
  },
  "likes": 12,
  "sentimentScore": 2,
  "sentimentLabel": "positive",
  "sourceUrl": "https://api.stocktwits.com/api/2/streams/symbol/NVDA.json"
}

---

Tips for Best Results

Start With QA-Safe Limits

• Use maxSymbols: 20 and maxNewsItems: 20 for faster validation runs
• Increase limits gradually after confirming output quality

Use Proxy When Reliability Drops

• Enable proxyConfiguration if you see repeated request failures
• Residential pools usually improve consistency under heavier usage

Calibrate Sentiment for Your Strategy

• Use sentimentLabel for quick filtering and alert conditions
• Combine sentiment with likes and timestamps for stronger context

Proxy Configuration

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

---

Integrations

Connect your dataset with:

• Google Sheets — Build shareable sentiment trackers
• Airtable — Create searchable market narrative databases
• BigQuery — Run large-scale analytics and historical comparisons
• Make — Automate cross-tool workflows without custom code
• Zapier — Trigger alerts and follow-up actions
• Webhooks — Send data directly to your own services

Export Formats

• JSON — API and engineering workflows
• CSV — Spreadsheet and BI usage
• Excel — Reporting and stakeholder sharing
• XML — System-to-system integrations

---

Frequently Asked Questions

Do I need API credentials?

No. The actor collects publicly accessible Stocktwits data and runs without user-supplied API keys.

Why are there occasional error records in output?

Temporary blocking or network issues can happen. Error records preserve run visibility while helping you monitor reliability.

How many items can I collect?

You can raise limits above defaults, but start small to validate quality and runtime in your environment.

Where is the run summary stored?

Summary metadata is stored in the key-value store record OUTPUT.

Can I run only one data source?

Yes. You can independently enable or disable trending symbols and news collection.

---

Support

For issues or feature requests, use the Issues tab in this repository or contact support through the Apify Console.

Resources

• Apify Documentation
• Apify API Reference
• Apify Scheduling

---

Legal Notice

This actor is intended for legitimate data collection and analysis. You are responsible for complying with platform terms and applicable laws in your jurisdiction. Use collected data responsibly.