JustSERPDocs
Yahoo

Yahoo Search

One page of Yahoo's web results (7 a page) for a query, answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`, `page`), `organic_results`, `local_results`, `related_questions`, `top_stories`, `ads` and `pagination`.

GET
/v1/yahoo/search

One page of Yahoo's web results (7 a page) for a query, answered as the document: search_metadata, search_parameters, search_information (query_displayed, page), organic_results, local_results, related_questions, top_stories, ads and pagination. Not answered: answer_box, knowledge_graph, inline_images, inline_videos, related_searches, trending_searches, sitelinks. A location is refused (Yahoo takes no place); zero_retention is not handled.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q*string

What to search for (p).

Length1 <= length <= 1000
device?"desktop"

Anything but desktop is a 400.

Default"desktop"
Value in"desktop"
yahoo_domain?string

One of Yahoo's regional hosts (uk.search.yahoo.com, de.search.yahoo.com...). Their second layout is read too.

Default"search.yahoo.com"
page?integer

7 results a page: b=(page-1)*7+1&pz=7.

Range1 <= value <= 100
Default1
safe?string

Written as vm=r|i|p; the effect was not measured.

Value in"on""moderate""off"
allowed_domains?string

Comma separated domains; (site:a OR site:b) is added to the query.

strict_match?string

on puts the query in quotes.

Default"off"
Value in"on""off"
time_period?string

btf=m|w|d.

Default"any_time"
Value in"any_time""last_month""last_week""last_day"

Response Body

The results page, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The Yahoo Search document. A block is present only when the page has it.

search_metadata*
search_parameters*

The request's own fields as sent, engine first, without cancel_token.

search_information*

The parser's own, e.g. yelp_search's; otherwise {}.

organic_results?array<>
local_results?array<>

The local pack's cards. Address and phone are not on the card.

related_questions?array<>
top_stories?array<>

The first story of the module only.

ads?array<>

Seen on 2 of 12 pages.

pagination?
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/yahoo/search?q=best+pizza+in+chicago&page=2'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {    "query_displayed": "string",    "page": 0  },  "organic_results": [    {      "position": 0,      "title": "string",      "link": "string",      "displayed_link": "string",      "source": "string",      "snippet": "string",      "snippet_highlighted_words": [        "string"      ],      "date": "string",      "favicon": "string",      "tabbed_snippets": [        {          "title": "string",          "text": "string"        }      ]    }  ],  "local_results": [    {      "position": 0,      "title": "string",      "link": "string",      "type": "string",      "price": "string",      "rating": 0,      "reviews": 0,      "reviews_source": "string",      "extensions": [        "string"      ]    }  ],  "related_questions": [    {      "question": "string",      "answer": "string"    }  ],  "top_stories": [    {      "title": "string",      "link": "string",      "source": "string",      "date": "string",      "snippet": "string",      "thumbnail": "string"    }  ],  "ads": [    {      "position": 0,      "block_position": "string",      "title": "string",      "link": "string",      "tracking_link": "string",      "displayed_link": "string",      "snippet": "string"    }  ],  "pagination": {    "current": 0,    "next": "string"  }}

Bing Copilot Search GET

The AI answer Bing Copilot Search ("AI Mode") writes for a question, logged out, answered as the document: `search_metadata`, `search_parameters`, `search_information` (empty), `text_blocks` (paragraphs, headers, lists, tables, images, code), `markdown` and `reference_links` (the sources it cites, by the numbers `text_blocks[].reference_indexes` use).

DuckDuckGo Search GET

One page (10) of DuckDuckGo's web results for a query, answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`), `organic_results`, `ads` and `pagination`.