Value Investors Club APIvalueinvestorsclub.com ↗
Access Value Investors Club investment ideas via API. Retrieve stock picks, ticker symbols, ratings, market cap, position type, and author IDs with filtering and pagination.
What is the Value Investors Club API?
The Value Investors Club API exposes 1 endpoint — list_ideas — that returns up to 10 investment ideas per page, each carrying 10+ fields including company name, ticker symbol, price, market cap in millions, position type, rating score, vote count, date posted, and a description preview. You can filter by geographic location, position type (long or short), date range, and sort by overall rating, quality, performance, recency, or activity.
curl -X GET 'https://api.parse.bot/scraper/2968696f-1f2f-4173-88f2-524cd3e38e6d/list_ideas?show=all&sort=highest_rated&location=all&position=all&daterange=6' \ -H 'X-API-Key: $PARSE_API_KEY'
List investment ideas from Value Investors Club with sorting and filtering. Each idea includes company name, ticker symbol, price, market cap, rating score, number of rating votes, position type (long/short), date posted, a description preview, and a user ID identifying the author. Sort by highest overall rated, highest quality rated, highest performance rated, most active, or most recent. Filter by long/short position, time range, show type, and geographic location. Returns up to 10 ideas per page. Non-members see 'member' as the author display name but receive unique user IDs that consistently identify each author across ideas. Ideas are limited to those posted within the last 90 days for non-members, unless using the 'all' daterange with a rated sort.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination, starting at 1. Each page returns up to 10 ideas. |
| show | string | Which category of ideas to display. |
| sort | string | How to sort the ideas list. |
| location | string | Geographic location filter. Use 'all' for all locations, 'us' for US only, 'nus' for non-US only, or a specific country code (e.g. 'LN' for UK, 'JP' for Japan, 'CA' for Canada, 'DE' for Germany, 'AU' for Australia). |
| position | string | Filter by position type. |
| daterange | string | Time range filter for ideas. Applies to all sort modes. For rated and most_active sorts, controls the lookback window. |
{
"type": "object",
"fields": {
"page": "current page number",
"count": "number of ideas returned on this page",
"ideas": "array of idea objects, each containing id, key_id, company_name, symbol, price, market_cap_millions, position_type, date_posted, formatted_date, rating, rating_votes, author_display_name, user_id, description_preview, is_contest_winner, idea_url, and total_return_pct"
},
"sample": {
"data": {
"page": 1,
"count": 10,
"ideas": [
{
"id": 162435,
"price": "17.87",
"key_id": "1024886954",
"rating": 6.3,
"symbol": "VISN",
"user_id": 44971,
"idea_url": "https://valueinvestorsclub.com/idea/VISTANCE_NETWORKS_INC/1024886954",
"date_posted": "2026-03-05 19:32:53",
"company_name": "VISTANCE NETWORKS INC",
"rating_votes": 17,
"position_type": "long",
"formatted_date": "Mar 5, 2026",
"total_return_pct": null,
"is_contest_winner": false,
"author_display_name": "member",
"description_preview": "Executive Summary Vistance Networks is sitting in the middle of a rare set of inefficiencies...",
"market_cap_millions": "3,950"
}
]
},
"status": "success"
}
}About the Value Investors Club API
What the API Returns
The list_ideas endpoint returns a paginated list of investment ideas published on Value Investors Club. Each idea object includes id, key_id, company_name, symbol, price, market_cap_millions, position_type (long or short), date_posted, a description preview field, a rating score, and the number of rating votes. A user_id field identifies the author of each idea, which allows you to track a contributor's submissions across multiple ideas even though author names are not exposed to unauthenticated access — those requests return 'member' as the display name.
Filtering and Sorting
The list_ideas endpoint accepts several optional parameters. The sort parameter controls ordering: options include overall rating, quality rating, performance rating, recency, and most active. The location parameter accepts 'all', 'us', 'nus' (non-US), or a specific country or region string. The position parameter filters for long-only or short-only ideas. The daterange parameter restricts results to a lookback window and interacts with sort modes such as rated and most_active. Pagination is controlled via the page parameter, starting at 1, with each page returning up to 10 results.
Response Structure
The top-level response includes page (current page number), count (number of ideas on the page), and ideas (the array of idea objects). The market_cap_millions field gives a numeric market cap figure useful for screening by company size. The show parameter allows selecting a specific category of ideas to display, giving you additional control over which subset of the community's submissions you retrieve.
The Value Investors Club API is a managed, monitored endpoint for valueinvestorsclub.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when valueinvestorsclub.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official valueinvestorsclub.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Screen for short-side investment theses by filtering
positionto short and sorting by quality rating - Track a prolific contributor's ideas over time using the
user_idfield across paginated results - Build a non-US equity watchlist by setting
locationto 'nus' and sorting by performance rating - Aggregate small-cap idea flow by combining
market_cap_millionsvalues with a date range filter - Monitor recent community activity by sorting
list_ideasby recency and polling on a schedule - Compare long vs. short idea volume in a given date range by making parallel filtered requests
- Feed a quantitative backtest pipeline with ticker symbols, position types, and post dates from the ideas array
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Value Investors Club have an official developer API?+
What does the `list_ideas` endpoint return for author information?+
user_id that identifies the author. Author display names are only visible to logged-in members of the site; unauthenticated access returns 'member' as the author name. The user_id field is consistent across ideas, so you can group or track a contributor's submissions without needing the display name.Does the API return the full text of each investment thesis?+
list_ideas endpoint returns a description preview field rather than the complete thesis text. The API covers company name, ticker, price, market cap, position type, ratings, vote counts, date posted, and author user ID. You can fork it on Parse and revise it to add an endpoint that retrieves the full idea detail page.Can I filter ideas by sector, industry, or market cap range directly?+
location, position, daterange, and show category. The market_cap_millions field is returned per idea, so you can filter by size client-side. You can fork this API on Parse and revise it to add server-side sector or market cap range filtering.How does pagination work and how many ideas are returned per page?+
page parameter starts at 1. Each page returns up to 10 ideas. The response includes a count field confirming how many ideas are present on the current page, and a page field echoing the current page number. Iterate through pages incrementally to retrieve larger result sets.