TipRanks APItipranks.com ↗
Access TipRanks Smart Score rankings, analyst price targets, consensus ratings, and earnings movement data for any stock ticker via two REST endpoints.
What is the TipRanks API?
The TipRanks API exposes two endpoints that return analyst consensus data, Smart Score rankings, individual analyst price targets, and earnings reports that triggered price moves greater than 6%. Use get_best_stocks to pull a ranked list of top-scoring stocks with upside percentages, or get_stock_info to query a specific ticker for full analyst breakdowns and company fundamentals.
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 Core Data
The get_best_stocks endpoint returns an array of stock objects sorted by consensus upside potential. Each object includes the stock's Ticker, Company name, Smart Score, Current Price, Consensus Upside %, Analyst Detailed Ratings, and an Earnings field that flags significant price movements. An optional limit parameter controls how many results are returned, useful for building a focused watchlist or screener view.
Per-Ticker Detail
The get_stock_info endpoint accepts a ticker parameter (e.g. AAPL, TSLA, MSFT) and returns a single object with deeper detail: individual analyst price targets, buy/hold/sell breakdown, Company Info, Current Price, Consensus rating, and Earnings Reports filtered to moves greater than 6%. This makes it practical for evaluating a specific holding or validating a trade idea against the analyst consensus before acting.
Coverage and Freshness
Both endpoints reflect TipRanks' aggregated analyst data, which consolidates ratings across sell-side analysts tracked by TipRanks. The Earnings Reports field specifically surfaces historical earnings events that caused meaningful price dislocations, giving context for how a stock reacts to earnings beats and misses. Coverage is limited to equities tracked by TipRanks; not all global exchanges or micro-cap names will be present.
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 daily screener that surfaces the highest Smart Score stocks with the largest consensus upside.
- Aggregate analyst buy/hold/sell ratios across a portfolio of tickers using
get_stock_info. - Flag earnings dates where a stock historically moved more than 6% to inform options strategy.
- Display consensus price targets alongside current price for a stock comparison tool.
- Monitor changes in analyst detailed ratings for a watchlist of tickers over time.
- Enrich a portfolio tracker with TipRanks Smart Scores pulled via
get_best_stocks. - Research a single stock's analyst coverage depth and price target spread before a position.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.