Retrieve Yahoo search results and suggestions based on a query. Useful for keyword research, SEO analysis, privacy-focused search insights, and understanding user intent.

If you already know that you want to use Yahoo Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.

At a Glance

Field	Value
Name	Yahoo Search
Scraper	yahoo_search
Engine	yahoo_search
Website	Yahoo
Website URL	Yahoo.com
Output Format	json
Version	1.0.0
Parameter Count	9
Parameter Groups	Pagination (1), Search Query (1), Localization (3), Advanced Filters (3), Request Controls (1)

Request Example

This is the real request body used to validate yahoo_search during this docs refresh. For /v1/serp, the engine field should be the engine's scraper value.

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"yahoo_search","q":"openai"}'

Response Example

The JSON below comes from the same live response. Long strings, data URLs, and large arrays were shortened so the example stays readable.

{
  "search_metadata": {
    "created_at": "2026-03-26 08:33:57 UTC",
    "id": "01KMMMEF16J2S94V1AZXJ0JRD3",
    "json_endpoint": "https://serp.xcrawl.com/01KMMMEF16J2S94V1AZXJ0JRD3.json",
    "processed_at": "2026-03-26 08:33:57 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMMEF16J2S94V1AZXJ0JRD3.html",
    "status": "completed",
    "total_time_taken": 9
  },
  "search_parameters": {
    "engine": "yahoo_search",
    "q": "openai"
  },
  "total_credits_used": 1,
  "ads_results": [
    {
      "block_position": "top",
      "favicon": "https://up.yimg.com/ib/th?id=OADD2.1272134981145483_156MVKVJMXBUFZO&pid=21.2&w=16&c=1&rs=1&qlt=95",
      "link": "https://azure.microsoft.com/en-us/products/ai-foundry/models/openai/?ef_id=_k_20e388f1d60712649663e13539767090_k_&OCID=AIDcmmhvcv1sd6_SEM_k_20e388f1d60712649663e13539767090&utm_source=bing&utm_medium=cpc&utm_campaign=590... [truncated, 344 chars]",
      "position": 0,
      "sitelinks": {
        "expanded": [
          {
            "link": "https://azure.microsoft.com/en-us/pricing/calculator/?ef_id=_k_e2a11b7c81f4124a4e5a72b86e85c6b9_k_&OCID=AIDcmmhvcv1sd6_SEM_k_e2a11b7c81f4124a4e5a72b86e85c6b9&utm_source=bing&utm_medium=cpc&utm_campaign=590417846&utm_adgr... [truncated, 329 chars]",
            "snippet": "Azure Pricing Calculator",
            "title": "Azure Pricing Calculator"
          },
          {
            "_note": "1 more items omitted"
          }
        ]
      },
      "snippet": "Sign Up for an Account Today and Start Using Azure OpenAI Service. Build Cutting-Edge Applications with Large-Scale, Generative AI Models Backed by Azure. ",
      "title": "Deep Learning For Your Apps - Create Your Account Today"
    }
  ],
  "knowledge_graph": {
    "image": "https://s.yimg.com/zb/imgv1/4101d01f-a338-3734-958b-9574654493d2/t_500x300",
    "profiles": [
      {
        "link": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIAHBBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Nj?ei=UTF-8&p=DeepSeek&d=%7B%22domain%22%3A%22company%22%2C%22type%22%3A%22yk%22%2C%22id%22%3A%22fa8fdff2-08f9-42ef-b93... [truncated, 304 chars]",
        "name": "DeepSeek"
      },
      {
        "_note": "9 more items omitted"
      }
    ]
  },
  "organic_results": [
    {
      "displayed_link": "",
      "link": "https://news.search.yahoo.com/search;_ylt=Awrhblpw78RpJgIA5A9XNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Nj?p=openai&fr=fp-tts&fr2=p%3As%2Cv%3Aw%2Cm%3Anewsdd_tnn_t%2Cct%3Abing",
      "position": 0,
      "snippet": "OpenAI is shutting down its Sora video app six months after launch and Disney's $1 billion deal is off. Here is what happened and what comes next.",
      "snippet_highlighted_words": [],
      "title": "Top Stories"
    },
    {
      "_note": "5 more items omitted"
    }
  ],
  "pagination": {
    "current": 1,
    "next": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIADRBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3BhZ2luYXRpb24-?ei=UTF-8&fr=fp-tts&p=openai&b=8&pz=7&bct=0&xargs=0&pstart=3",
    "other_pages": {
      "2": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIACRBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3BhZ2luYXRpb24-?ei=UTF-8&fr=fp-tts&p=openai&b=8&pz=7&bct=0&xargs=0&pstart=3",
      "3": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIAChBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3BhZ2luYXRpb24-?ei=UTF-8&fr=fp-tts&p=openai&b=15&pz=7&bct=0&xargs=0&pstart=5",
      "4": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIACxBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3BhZ2luYXRpb24-?ei=UTF-8&fr=fp-tts&p=openai&b=22&pz=7&bct=0&xargs=0&pstart=7",
      "5": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIADBBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3BhZ2luYXRpb24-?ei=UTF-8&fr=fp-tts&p=openai&b=29&pz=7&bct=0&xargs=0&pstart=9"
    }
  },
  "related_questions": [
    {
      "link": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIA.A9XNyoA;_ylu=Y29sbwNiZjEEcG9zAzIEdnRpZAMEc2VjA3Nj?ei=UTF-8&p=Where+is+OpenAI+headquarters%3F&fr2=p%3As%2Cv%3Aw%2Cm%3AnuwaPeopleAlsoAsk&fr=fp-tts",
      "title": "Where is OpenAI headquarters?"
    },
    {
      "_note": "3 more items omitted"
    }
  ],
  "related_searches": {
    "bottom": [
      {
        "link": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIAARBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3JlbC1ib3Q-?ei=UTF-8&p=openai+discontinues+sora+video+platform&fr2=p%3As%2Cv%3Aw%2Cm%3Ars-bottom%2Cct%3Agossip&fr=fp-tts",
        "query": "openai discontinues sora video platform"
      },
      {
        "_note": "7 more items omitted"
      }
    ]
  },
  "search_information": {
    "query_displayed": "openai"
  },
  "trending_searches": {
    "results": [
      {
        "link": "https://search.yahoo.com/search;_ylt=Awrhblpw78RpJgIAMRBXNyoA;_ylu=Y29sbwNiZjEEcG9zAzEEdnRpZAMEc2VjA3Nj?ei=UTF-8&p=NCIS&fr2=p%3As%2Cv%3Aw%2Cm%3Atn%2Cct%3Aall%2Cpg%3A1%2Cstl%3Atxt%2Ckt%3Aorg%2Cb%3A&fr=fp-tts",
        "position": 0,
        "title": "NCIS kills off major character in 500th episode",
        "trending": 0
      },
      {
        "_note": "5 more items omitted"
      }
    ]
  }
}

Required Parameters

If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.

Field	Type	Group	Description
q	string	Search Query	The keyword or phrase you want this search engine to look up.

Available Parameters

The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.

Pagination

Field	Type	Required	Description
b	string	No	Result offset used for Yahoo-style pagination.

Search Query

Field	Type	Required	Description
q	string	Yes	The keyword or phrase you want this search engine to look up.

Localization

Field	Type	Required	Description
vc	string	No	Yahoo country code used to localize results.
vl	string	No	Yahoo language filter.
yahoo_domain	string	No	Yahoo domain to query, such as the default global domain or a regional one.

Additional Constraints

• vc：Options: 94 options. Examples: al, dz, ar, am, au
• vl：Options: 32 options. Examples: lang_ar, lang_bg, lang_zh_chs, lang_zh_cht, lang_hr
• yahoo_domain：Options: 40 options. Examples: espanol, be, fr, br, ca

Advanced Filters

Field	Type	Required	Description
vf	string	No	Yahoo file-type filter, such as PDF, DOC, or TXT.
vm	string	No	Yahoo safe-search level.
vs	string	No	Limit Yahoo results to specific top-level domains, such as .com or .org.

Additional Constraints

• vf：Options: 6 options. Examples: html, pdf, xls, ppt, doc
• vm：Options: 3 options. Examples: r, i, p

Request Controls

Field	Type	Required	Description
device	string	No	Device type used when requesting results, such as desktop or tablet.

Additional Constraints

• device：Options: 1 options. Examples: desktop

Previous pageBing Search

Next pageGoogle Map Search