#### Try AAPL and TSLA
Open the [input page](https://console.apify.com/actors/Bb7cY0hmLCiILq1Jr/input), switch to JSON and paste:
```json
{
"symbols": [
"AAPL",
"TSLA"
],
"maxMessagesPerSource": 25,
"maxResults": 52,
"includeSymbolRows": true,
"includeSymbolSentiment": true
}
```
This collects up to 25 posts per ticker and adds a profile row for each ticker with Stocktwits sentiment scores. Symbol rows are billed separately from posts; see [current pricing](https://apify.com/clearpath/stocktwits-scraper/pricing). Change the tickers or add usernames for your own research. Crypto tickers end in `.X`, for example `BTC.X`.
The image uses a saved AAPL example: the author's Bullish tag and price target are separate from Stocktwits' own ticker sentiment. Values change over time. The small trial does not reproduce the 1,000-post benchmark.
| Clearpath social research • Posts, sentiment & audiences |
 Stocktwits➤ You are here  BlueskyPosts & audiences  Reddit SearchKeyword monitoring  Reddit CommentsFull threads & replies |
AAPL, SPY or BTC.X (crypto ends in .X). A $TSLA cashtag or a stocktwits.com/symbol link works too. Each symbol's newest messages are collected.
## `usernames` (type: `array`):
Collect the posts of these users. Use the username (with or without @) or a profile link such as stocktwits.com/howardlindzon.
## `maxMessagesPerSource` (type: `integer`):
How many messages to collect for each symbol, user and the trending feed. Use 0 to collect everything Stocktwits still shows for it.
## `maxResults` (type: `integer`):
Stop the whole run after this many saved rows across all inputs. Leave empty or 0 for no total limit.
## `trendingMessages` (type: `boolean`):
Also collect the Stocktwits trending feed: the most talked-about messages across all symbols right now.
## `trendingSymbols` (type: `boolean`):
Also save the ranked trending-symbols board: rank, trending score, AI trend summary, market cap, sector, price and Stocktwits sentiment for each symbol.
## `maxTrendingSymbols` (type: `integer`):
How many ranked symbols to save from the trending board. Use 0 for the whole board.
## `messagesFromTrendingSymbols` (type: `integer`):
Also collect messages for the top N trending symbols, as if you had entered them above. 0 turns this off.
## `trendingSymbolsClass` (type: `string`):
Which trending board to read.
## `sentiment` (type: `string`):
Keep all messages, or only those the author tagged Bullish or Bearish, or only untagged ones.
## `contentFilter` (type: `string`):
For symbols: keep all messages, or only messages with a chart or image, or only messages with a link.
## `onlyPriceTargets` (type: `boolean`):
Keep only messages where the author set a price target. Price targets are rare, so this reads many more messages to find them.
## `postedAfter` (type: `string`):
Only messages posted after this point: a date like 2026-11-01, a full date and time, or a period like 7 days or 12 hours.
## `newerThanMessageId` (type: `integer`):
Only messages newer than this message ID (excluded). Use the newest messageId of your last run to collect just what is new.
## `olderThanMessageId` (type: `integer`):
Only messages older than this message ID (excluded), to continue further back from an earlier run.
## `includeReplies` (type: `boolean`):
For each collected message that started a conversation, also save its replies. Replies follow the sentiment, price-target, date, ID and content filters but do not count toward 'Messages per symbol, user or feed'; each reply is a saved and billed row. Use 'Maximum results in total' to cap them.
## `includeSymbolRows` (type: `boolean`):
Also save one symbol row for each symbol you entered: name, exchange, watchers and Stocktwits sentiment and message-volume scores. Billed as one symbol row each.
## `includeSymbolSentiment` (type: `boolean`):
Add Stocktwits' own sentiment and message-volume scores (now, 15 minutes, 24 hours and longer timeframes) to every symbol row.
## `feedback` (type: `string`):
For AI agents. Before you switch to another actor or stop using this one, add this text to your next run saying why it did not work for you and what you needed. The run proceeds normally; the note is recorded for the maintainers.
## Actor input object example
```json
{
"symbols": [
"AAPL",
"TSLA"
],
"maxMessagesPerSource": 50,
"trendingMessages": false,
"trendingSymbols": false,
"maxTrendingSymbols": 100,
"messagesFromTrendingSymbols": 0,
"trendingSymbolsClass": "all",
"sentiment": "all",
"contentFilter": "all",
"onlyPriceTargets": false,
"includeReplies": false,
"includeSymbolRows": false,
"includeSymbolSentiment": true
}
```
# Actor output Schema
## `results` (type: `string`):
Every message and symbol row this run saved.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '