Skip to main content
POST
Live Yahoo Organic SERP HTML
Returns the ranked results for a keyword on Yahoo, synchronously. Raw page source rather than parsed results. 🔴 Measured at 2.4 MB for a ten-result Google query, against 57 KB parsed - take it only to check what the parser dropped. Wrapped in DataForSEO’s envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

Example

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. The commands per client, and what each call costs, are on aisa.one/mcp.
Set this endpoint up in your agent →

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
keyword
string
required

keyword required field you can specify up to 700 characters in the keyword field all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the "%" character for your keyword, please specify it as "%25"; if you need to use the “+” character for your keyword, please specify it as “%2B” learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article

location_name
string

full name of search engine location required field if you don't specify location_code or location_coordinate if you use this field, you don't need to specify location_code or location_coordinate. Use the AIsa tool get_dataforseo_serp_yahoo_locations to retrieve supported Yahoo locations. Select a location from the returned list and use its location_name value exactly. When using MCP, discover this tool through search and obtain its schema with batch_get_schema if needed. example: London,England,United Kingdom

location_code
integer

search engine location code required field if you don't specify location_name_or location_coordinate if you use this field, you don't need to specify location_name or location_coordinate. Use the AIsa tool get_dataforseo_serp_yahoo_locations to retrieve supported Yahoo locations. Select a location from the returned list and use its location_code value exactly. When using MCP, discover this tool through search and obtain its schema with batch_get_schema if needed. example: 2840n

language_name
string

full name of search engine language required field if you don't specify language_code if you use this field, you don't need to specify language_code. Use the AIsa tool get_dataforseo_serp_yahoo_languages to retrieve supported Yahoo languages. Select a language from the returned list and use its language_name value exactly. When using MCP, discover this tool through search and obtain its schema with batch_get_schema if needed. example: English

language_code
string

search engine language code required field if you don't specify language_name if you use this field, you don't need to specify language_name. Use the AIsa tool get_dataforseo_serp_yahoo_languages to retrieve supported Yahoo languages. Select a language from the returned list and use its language_code value exactly. When using MCP, discover this tool through search and obtain its schema with batch_get_schema if needed. example: enn

device
string

device type optional field return results for a specific device type can take the values:desktop, mobile default value: desktop

os
string

device operating system optional field if you specify desktop in the device field, choose from the following values: windows, macos default value: windows if you specify mobile in the device field, choose from the following values: android, ios default value: android

Response

Successful operation

version
string

The current version of the API

status_code
integer

general status code you can find the full list of the response codes here

status_message
string

general informational message you can find the full list of general informational messages here

time
string

total execution time, seconds

cost
number

Total tasks cost, USD

tasks
string[]

Array of tasks

tasks[].result
string[]

array of results