Provided by DataForSEO
Get advanced Yahoo organic search results for a keyword with DataForSEO
Read the organic Yahoo result page for one keyword in one location and language, as Yahoo ranked it. Yahoo's own page. One request per call, priced by the vendor's own rate card; an empty result set is reported as no result.
How to run it
Step 1Set up
Once: paste this into your agent's chat. The Skill installs the CLI and logs in by itself. For an agent that cannot use a shell, connect it over MCP instead.
set up https://glasser.ai/SKILL.md
Show me how to use the DataForSEO endpoint /v3/serp/yahoo/organic/live/advanced on Glasser.glasser run -p dataforseo -e '/v3/serp/yahoo/organic/live/advanced' -i '{"keyword":"albert einstein","language_code":"en","location_code":2840}' --endpoint-version 6Uses endpoint version 6. Inspect the current price before running. Install and log in first on Get Started.
Once per Run:
IDEMPOTENCY_KEY=$(uuidgen)Run it, and copy this same block to send it again:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"dataforseo","endpoint":"/v3/serp/yahoo/organic/live/advanced","input":{"keyword":"albert einstein","language_code":"en","location_code":2840},"endpoint_version":6}'Reuse the same Idempotency-Key to send it again: the second send is a read of the first Run. A new key is a new Run and a new Charge. Uses endpoint version 6; inspect the current price before running.
Step 2Try a specific example task
When you need to research a question, you might search for relevant sources and review which results are worth reading more closely.
Copy this prompt into your agent to find sources for your research question.
Use dataforseo:/v3/serp/yahoo/organic/live/advanced on Glasser.
Search for sources about my research question and explain which returned results are relevant.Endpoint structure
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"keyword"
],
"properties": {
"os": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"url": {
"type": "string",
"description": "Direct search URL, parsed into the request by DataForSEO. Paging inside it is billed per page."
},
"depth": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results to collect (1-200, default 6). DataForSEO bills each page of up to 5 results."
},
"device": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"target": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"keyword": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"se_domain": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"search_param": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_code": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_name": {
"type": "string"
},
"location_code": {
"type": "integer"
},
"location_name": {
"type": "string"
},
"max_crawl_pages": {
"type": "integer",
"description": "Search result pages to crawl (max 100). DataForSEO bills each page crawled."
},
"location_coordinate": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"stop_crawl_on_match": {
"type": "object",
"description": "Keep crawling result pages until these targets appear. DataForSEO bills each page crawled."
}
},
"additionalProperties": false
}{
"keyword": "albert einstein",
"language_code": "en",
"location_code": 2840
}This Endpoint publishes no output schema. You get the Provider's own response body, unchanged — we do not warrant a shape we cannot guarantee.
How pricing works
| Default-size input | Larger inputs and paid options vary with Provider usage. The same price with or without matching data. | $0.002 |
|---|---|---|
| Maximum per Run | The total charge will not exceed this amount. | $1.00 |
| Provider error | The Provider failed to answer. | $0.00 |
| Timed out | The Run exceeded its time limit. | $0.00 |
| Internal failure | An internal error prevented completion. | $0.00 |