TipRanks APItipranks.com ↗
Access TipRanks Smart Score rankings, analyst consensus ratings, price targets, and earnings movement data via a structured JSON API.
What is the TipRanks API?
The TipRanks API covers 3 endpoints that expose stock rankings, analyst ratings, and earnings data sourced from TipRanks. The get_stock_info endpoint returns over 15 distinct fields for a single ticker — including analyst buy/hold/sell breakdown, individual analyst price targets, CEO and sector details, and earnings reports that triggered more than 6% price movement. Use get_best_stocks to pull a ranked list of top-scoring tickers in one call.
curl -X GET 'https://api.parse.bot/scraper/a2951930-9eb9-44e7-b2c4-dbd5d8d14074/get_best_stocks?limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace tipranks-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: TipRanks SDK — discover top stocks, drill into detail, handle errors."""
from parse_apis.tipranks_stock_analysis_api import TipRanks, TickerNotFound
client = TipRanks()
# List top-scored stocks, capped at 3 items total.
for summary in client.stocksummaries.top(limit=3):
print(summary.ticker, summary.company, summary.smart_score)
# Drill into the first result for full detail.
first = client.stocksummaries.top(limit=1).first()
if first:
stock = first.details()
print(stock.company, stock.current_price)
print(stock.consensus.buy, stock.consensus.hold, stock.consensus.sell)
for rating in stock.analyst_detailed_ratings[:2]:
print(rating.analyst_profile, rating.expert_firm, rating.price_target)
# Direct fetch by ticker via the stocks collection.
try:
apple = client.stocks.get(ticker="AAPL")
print(apple.company_info.sector, apple.company_info.industry)
except TickerNotFound as exc:
print(f"Ticker not found: {exc.ticker}")
print("exercised: stocksummaries.top / details / stocks.get / error handling")Fetches top stocks ranked by TipRanks Smart Score and sorted by consensus upside potential. Each stock includes analyst detailed ratings (name, firm, price target, action) and earnings reports that caused greater than 6% price movement. The screener data refreshes periodically; results reflect TipRanks' current top-scored universe. Returns a single page capped by limit.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of top stocks to return. |
{
"type": "object",
"fields": {
"items": "array of stock summary objects each containing Ticker, Company, Smart Score, Current Price, Consensus Upside %, Analyst Detailed Ratings, and Earnings Reports (>6% Move)"
},
"sample": {
"data": {
"items": [
{
"Ticker": "TCTZF",
"Company": "Tencent Holdings",
"Smart Score": 10,
"Current Price": 57.46,
"Consensus Upside %": null,
"Analyst Detailed Ratings": [
{
"Date": "2025-08-13",
"Action": "reiterated",
"Position": "buy",
"Expert Firm": "US Tiger Securities",
"Price Target": 82.34,
"Analyst Profile": "Bo Pei CFA",
"Upside / Downside": 43.31
}
],
"Earnings Reports (>6% Move)": [
{
"Date": "2025-08-13",
"Movement %": 7.77,
"Estimate EPS": 0.96,
"Reported EPS": 1
}
]
}
]
},
"status": "success"
}
}About the TipRanks API
Endpoints and Data Coverage
The get_best_stocks endpoint accepts an optional limit integer and returns an array of stock summary objects, each containing the ticker symbol, company name, TipRanks Smart Score, current price, consensus upside percentage, individual analyst ratings (analyst name, firm, price target, action), and any earnings reports that moved the stock more than 6%. This is the fastest way to retrieve a ranked shortlist of high-scoring names without querying each ticker individually.
The get_stock_info endpoint takes a required ticker string (e.g. AAPL, TSLA) and returns a full analysis object. The Consensus block includes consensus_rating, buy, hold, and sell counts, total_analysts, price_target, upside, price_target_high, and price_target_low. The Company Info block adds full_name, ceo, sector, industry, employees, description, and address. Analyst Detailed Ratings is an array where each entry carries the analyst profile, firm, price target, position, upside/downside percentage, action taken, and date. Earnings Reports (>6% Move) lists historical earnings events with reported EPS, estimated EPS, and the actual price movement percentage.
Combined Rankings Endpoint
get_top_stocks_and_analysts takes no inputs and returns two parallel arrays in a single response. top_smart_score_stocks lists the 10 highest SmartScore-ranked stocks with company name, ticker, smart score, current price, and consensus upside. top_analysts lists the 10 highest-rated Wall Street analysts with rank, name, firm, sector, success rate, average return, total ratings, followers, and TipRanks star rating. This endpoint is useful for dashboard-style views that need both dimensions without multiple round trips.
Data Freshness and Scope
The screener data behind get_best_stocks refreshes periodically rather than tick-by-tick, so current prices and consensus figures reflect the most recent screener snapshot rather than live quotes. Analyst rating actions (upgrade, downgrade, reiterate) and dates are included in the Analyst Detailed Ratings array, making it possible to filter for recency at the application layer. Earnings data is limited to reports that caused moves greater than 6%, not the full earnings history.
The TipRanks API is a managed, monitored endpoint for tipranks.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tipranks.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 tipranks.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?+
- Build a stock screener dashboard that surfaces the highest Smart Score tickers with consensus upside above a set threshold.
- Aggregate analyst price targets and buy/hold/sell counts for a watchlist to display consensus sentiment per ticker.
- Identify earnings events that historically moved a stock more than 6% to inform options strategies around upcoming earnings dates.
- Populate a company profile page with CEO, sector, industry, employee count, and address data from
get_stock_info. - Compare the top 10 analysts by success rate and average return to weight or filter analyst recommendations in a model portfolio.
- Track analyst rating actions and dates to detect recent upgrades or downgrades across a basket of tickers.
- Generate a combined leaderboard of top-rated stocks and top-performing analysts for a financial newsletter or research tool.
| 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 TipRanks have an official developer API?+
What does `get_stock_info` return that `get_best_stocks` does not?+
get_stock_info includes the full Company Info block (CEO, full company name, employees, description, address) and the complete Consensus breakdown with high and low price target bounds. get_best_stocks returns summary-level data across multiple tickers optimized for ranking views, but omits company fundamentals and the full target range.Is earnings data limited to significant moves only?+
get_best_stocks and get_stock_info return an Earnings Reports (>6% Move) array that only includes earnings events where the stock moved more than 6%. Full earnings history regardless of move size is not currently covered. You can fork this API on Parse and revise it to add an endpoint returning complete earnings history.