Skip to content

Yahoo API

Yahoo (yahoo.com) has 12 public methods: get quote, get price history, get analyst ratings, get company news, list Yahoo News headlines and 7 more. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

Unofficial. Not affiliated with or endorsed by Yahoo.

Methods

12
  • Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed.

    Returns name, ticker, exchange, latest price, change, day and 52-week ranges, volume, market cap, P/E, dividend, next earnings date, market state

    Readfinance.yahoo.com/get_quote
  • Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency.

    Returns name, ticker, currency, total return percent, price rows (date, open, high, low, close, adjusted close, volume)

    Readfinance.yahoo.com/get_price_history
  • Shows analyst recommendations, price targets, earnings estimates and recent rating changes for a public company on Yahoo Finance.

    Returns consensus rating, analyst counts, price targets, earnings and revenue estimates, recent rating changes

    Readfinance.yahoo.com/get_analyst_ratings
  • Looks up a company by name or ticker on Yahoo Finance and returns its latest news headlines, with article summaries when the article page provides one.

    Returns company name, ticker, and articles with headline, publisher, published time, summary, thumbnail, article URL, related tickers

    Readfinance.yahoo.com/get_company_news
  • Lists the latest Yahoo News headlines for a section in page order, with summary, byline, original publisher, image and publication time when the article provides them.

    Returns headline, summary, published_at, authors, original_publisher, section, image_link, article_link

    Readyahoo.com/list_headlines
  • Reads a public Yahoo News article from its link or headline and returns its text and details. Headline matching uses Yahoo News search results.

    Returns headline, summary, authors, dates, section, tags, main image, paragraphs, word count, link, id

    Readyahoo.com/read_article
  • Returns Yahoo Sports team standings for a league and season, grouped by division or conference.

    Returns group, rank, team, wins, losses, ties, overtime losses, win percentage, games behind, points, streak, last 10 games, team page URL

    Readsports.yahoo.com/get_standings
  • Looks up a Yahoo Sports player by name and returns the player's regular-season statistics for a season, alongside career totals. Each stat includes season and career values.

    Returns player, team, league, position, age, headshot, season, stats (season and career values), player ID

    Readsports.yahoo.com/get_player_stats
  • Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap.

    Returns company name, ticker, price, change, volume, market cap, P/E, quote link

    Readfinance.yahoo.com/list_market_movers
  • Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games.

    Returns start time, teams, scores, status, period, clock, TV channel, venue, game link

    Readsports.yahoo.com/get_scores
  • Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company.

    Returns company name, ticker, report date, time of day, EPS estimate, reported EPS, surprise percent, link

    Readfinance.yahoo.com/get_earnings_calendar
  • Searches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section.

    Returns headline, summary, published time, authors, original publisher, section, link

    Readyahoo.com/search_news