---
title: "Yahoo Finance search"
method: GET
path: "/yahoo-finance/search"
tags: ["Yahoo Finance"]
---

# Yahoo Finance search

`GET /yahoo-finance/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/yahoo-finance/search`
- Auth: API key in header `x-api-key`

Searches Yahoo Finance for the required `q`, a ticker symbol or company name, and returns matching `quotes`, `news` and `lists`, plus `research` reports when `include_research` is set and Yahoo returns them. `quotes_count`, `news_count` and `lists_count` set how many of each; `enable_fuzzy_query` turns on fuzzy matching.

## Query parameters

- `q` string, required
- `quotes_count` integer
- `news_count` integer
- `lists_count` integer
- `include_research` boolean
- `enable_fuzzy_query` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- YahoofinanceSearchResponseDoc
  - `code` integer
  - `data` YahoofinanceSearchResponse
    - `lists` object[]: Yahoo Finance lists matching the query.
    - `news` object[]: News articles matching the query.
    - `query` string: Search text that was run.
    - `quotes` object[]: Ticker and company matches.
    - `research` object[]
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)