Search API

Yahoo Search API

Yahoo search results as JSON from one GET request: organic results with their sitelinks, top and bottom sponsored results, and related searches. 10 credits a search, and a failed search costs nothing.

Try a Yahoo search Full reference

Quick start

curl "https://api.webfetch.io/v1/yahoo?search=best+coffee+maker" \
  -H "Authorization: Bearer wfk_your_key"

JavaScript (npm install @tuxxin/webfetch)

const r = await client.yahoo('best coffee maker');
r.organic_results[0].url;

Python (pip install webfetch-io)

r = client.yahoo("best coffee maker")
r["organic_results"][0]["url"]

PHP (composer require tuxxin/webfetch)

$r = $client->yahoo('best coffee maker');
$r['organic_results'][0]['url'];

Also served at https://webfetch.io/api/v1/yahoo . The key goes in the Authorization header, or in api_key. AI agents can run the same search with the MCP server's search_web tool.

How it works

You send the query and the options below. The search goes out through our proxy network from the country you pick, never from our own servers.
Every Yahoo search loads in a real browser. A light request skips images, fonts and media; a regular request loads the page in full.
If Yahoo answers with a bot check, the search is retried on another exit, up to three times within 90 seconds, and the exit that was blocked rests for a while.
The page is read into JSON in a fixed shape: every key is present on every response, lists are ranked from position 1, and result links are the destination pages.
A results page is billed, including one with no results. Anything else is not.

Parameters

Parameter	Default	What it does
`search`	required	The query, as typed in the search box. Operators such as `site:` work.
`country_code`	`us`	Two-letter country to search from.
`page`	`1`	Results page, 1 to 50. 7 results a page.
`light_request`	`true`	10 credits when true, 15 when false.
`search_type`	`classic`	`classic` for the full results page, `ads` for the ads only.
`add_html`	`false`	Also return the page's HTML, in `html`.
`tag`	none	Your own label, echoed back in `Wf-Tag`.

Response

A real Yahoo search for "best coffee maker" from GB, first results only. Empty lists are always present, so a client never checks whether a key exists.

{
    "meta_data": {
        "url": "https://search.yahoo.com/search?p=best%20coffee%20maker",
        "number_of_results": null,
        "location": null,
        "number_of_organic_results": 7,
        "number_of_ads": 8,
        "number_of_page": 1,
        "zero_results_for_original_query": false
    },
    "organic_results": [
        {
            "position": 1,
            "title": "The 9 Best Coffee Makers of 2026 | Reviews by Wirecutter",
            "url": "https://www.nytimes.com/wirecutter/reviews/best-coffee-maker/",
            "displayed_url": "https://www.nytimes.com \u203a wirecutter \u203a reviews",
            "description": "Over the years, we\u2019ve tried nearly every method of making coffee, from cold-brew coffee makers and the Chemex to moka pots and Moccamasters. For people who want pour-over-quality coffee as...",
            "domain": "www.nytimes.com",
            "date": "Mar 20, 2026",
            "date_utc": null,
            "rich_snippet": [],
            "sitelinks": [
                {
                    "title": "Why We Love The Oxo Coffee Maker for 2025",
                    "url": "https://www.nytimes.com/wirecutter/reviews/oxo-coffee-maker-review/"
                },
                {
                    "title": "Best Drip Coffee Maker",
                    "url": "https://www.nytimes.com/wirecutter/reviews/best-drip-coffee-maker/"
                }
            ]
        },
        {
            "position": 2,
            "title": "13 Best Coffee Makers of 2026, Lab Tested and Reviewed",
            "url": "https://www.consumerreports.org/appliances/coffee-makers/best-coffee-makers-of-the-year-a9612622702/",
            "displayed_url": "https://www.consumerreports.org \u203a appliances \u203a coffee-makers",
            "description": "Below are reviews of the best coffee makers we\u2019ve tested, grouped by type and listed in alphabetical order. CR members can click on each model name for more detailed ratings and specs.",
            "domain": "www.consumerreports.org",
            "date": "Oct 8, 2026",
            "date_utc": null,
            "rich_snippet": [],
            "sitelinks": []
        }
    ],
    "top_ads": [
        {
            "position": 1,
            "title": "View The Best Best Coffee Maker of 2026 - One Standout Winner",
            "url": "https://www.bestproductsreviews.co.uk/best+coffee+maker?msclkid=92b918afd61e10ec0f24727ea0eaae73&targetid=kwd-84595066004249:loc-4076&matchtype=e&device=c&campaignid=533174485&creative=&adgroupid=1353501498115637&feeditemid=&loc_physical_ms=41471&loc_interest_ms=&network=o&devicemodel=&placement=&keyword=$best%20coffee%20maker&target=&adposition=&trackid=uk_all_top_bing&mId=H149003CQN&utm_source=bestproductsreviews.co.uk~b&utm_campaign=YmVzdHByb2R1Y3RzcmV2aWV3cy5jby51a35i~533174485~1353501498115637&ctx=b~92b918afd61e10ec0f24727ea0eaae73&utm_medium=cpc&utm_term=best%20coffee%20maker&utm_content=buyersguide.org",
            "tracking_url": "https://r.search.yahoo.com/rdclks/dWU9NGYzMWtlaGxkMnRuayZ1dD0xNzkyMTEyMzcyMjI2JnVvPTg0NTk0MjYyNDc1NzM2Jmx0PTImcz0xJmVzPVhjeDVVb1BzWUxYNDZxbWR0MWdPVkZwUFZEcEZOS0VWVmE5b0tLZ0VJdEY3eVQ4aTRHX1dFUWdGS1NjWktESXRHTm1xYUs1SlF6aF9zZ0Ut/RV=2/RE=1794704372/RO=14/RU=https%3a%2f%2fwww.bing.com%2faclick%3fld%3de8fmhwKqDd2bjhxYy64xWOUDVUCUxWfkIp19tCAnvLMOZEUFeacF3Yv8n5R9v9d68sLS7IPEgCNZjk6VgK0R-9Biq9ZsP7HWHK3TR_hN4V-W1tYNzzQQy0Ps2jXD8o-Lm8iy8_RZkte1qLwf9pDZiBTmmyU9T1fK1I6huUCyDk-tNYXRGmbfeAaLVWT6a3vn3sjIBKrg%26u%3daHR0cHMlM2ElMmYlMmZ3d3cuYmVzdHByb2R1Y3RzcmV2aWV3cy5jby51ayUyZmJlc3QrY29mZmVlK21ha2VyJTNmbXNjbGtpZCUzZDkyYjkxOGFmZDYxZTEwZWMwZjI0NzI3ZWEwZWFhZTczJTI2dGFyZ2V0aWQlM2Rrd2QtODQ1OTUwNjYwMDQyNDklM2Fsb2MtNDA3NiUyNm1hdGNodHlwZSUzZGUlMjZkZXZpY2UlM2RjJTI2Y2FtcGFpZ25pZCUzZDUzMzE3NDQ4NSUyNmNyZWF0aXZlJTNkJTI2YWRncm91cGlkJTNkMTM1MzUwMTQ5ODExNTYzNyUyNmZlZWRpdGVtaWQlM2QlMjZsb2NfcGh5c2ljYWxfbXMlM2Q0MTQ3MSUyNmxvY19pbnRlcmVzdF9tcyUzZCUyNm5ldHdvcmslM2RvJTI2ZGV2aWNlbW9kZWwlM2QlMjZwbGFjZW1lbnQlM2QlMjZrZXl3b3JkJTNkJTI0YmVzdCUyNTIwY29mZmVlJTI1MjBtYWtlciUyNnRhcmdldCUzZCUyNmFkcG9zaXRpb24lM2QlMjZ0cmFja2lkJTNkdWtfYWxsX3RvcF9iaW5nJTI2bUlkJTNkSDE0OTAwM0NRTiUyNnV0bV9zb3VyY2UlM2RiZXN0cHJvZHVjdHNyZXZpZXdzLmNvLnVrJTdlYiUyNnV0bV9jYW1wYWlnbiUzZFltVnpkSEJ5YjJSMVkzUnpjbVYyYVdWM2N5NWpieTUxYTM1aSU3ZTUzMzE3NDQ4NSU3ZTEzNTM1MDE0OTgxMTU2MzclMjZjdHglM2RiJTdlOTJiOTE4YWZkNjFlMTBlYzBmMjQ3MjdlYTBlYWFlNzMlMjZ1dG1fbWVkaXVtJTNkY3BjJTI2dXRtX3Rlcm0lM2RiZXN0JTI1MjBjb2ZmZWUlMjUyMG1ha2VyJTI2dXRtX2NvbnRlbnQlM2RidXllcnNndWlkZS5vcmc%26rlid%3d92b918afd61e10ec0f24727ea0eaae73/RK=2/RS=t7YtLXyV9porAVHEblJvJpR42nI-;_ylt=A2RSU4z0dtFqCgMA569XNyoA;_ylu=Y29sbwNldS13ZXN0LTEEcG9zAzEEdnRpZAMEc2VjA292LXRvcA--;_ylc=cnQDMQ--?IG=6452538cfa9244e1906ad176f4832747",
            "visual_url": "www.bestproductsreviews.co.uk",
            "domain": "www.bestproductsreviews.co.uk",
            "description": "Best coffee maker and other top-rated items for Home & Kitchen are reviewed by our experts. Find the right products that fit your budget and needs",
            "snippet": null,
            "sitelinks": []
        }
    ],
    "bottom_ads": [
        {
            "position": 1,
            "title": "View The Best Best Coffee Maker of 2026 - One Standout Winner",
            "url": "https://www.bestproductsreviews.co.uk/best+coffee+maker?msclkid=a2a44c8c373d1a5f3cf6265d41c97a5f&targetid=kwd-84595066004249:loc-4076&matchtype=e&device=c&campaignid=533174485&creative=&adgroupid=1353501498115637&feeditemid=&loc_physical_ms=41471&loc_interest_ms=&network=o&devicemodel=&placement=&keyword=$best%20coffee%20maker&target=&adposition=&trackid=uk_all_top_bing&mId=H149003CQN&utm_source=bestproductsreviews.co.uk~b&utm_campaign=YmVzdHByb2R1Y3RzcmV2aWV3cy5jby51a35i~533174485~1353501498115637&ctx=b~a2a44c8c373d1a5f3cf6265d41c97a5f&utm_medium=cpc&utm_term=best%20coffee%20maker&utm_content=buyersguide.org",
            "tracking_url": "https://r.search.yahoo.com/rdclks/dWU9NGYzMWtlaGxkMnRuayZ1dD0xNzkyMTEyMzcyMjI2JnVvPTg0NTk0MjYyNDc1NzM2Jmx0PTImcz0xJmVzPWVGX2NPM3BaRWVOWkRuRzBTbEoxbUZpVWlwbnBmM18wWXdiN3VfXzQ2UlVFUHlKeVd3Qkx6ODFfVzFIZ1NWMjFVSkVpUm0xclViNXNEYWst/RV=2/RE=1794704372/RO=14/RU=https%3a%2f%2fwww.bing.com%2faclick%3fld%3de8XW66UKPVP6TNN4YA6KyawDVUCUzLeLY5a6N1-1__QzrEC6qdrqhRgRDDzrejOUkXXvP1cXzRA48OHCP0Yk-I-Ib7B_nneRSzgR6QFfWMaZtMYjVf0ghfFHATxYN_QRBaWh7E6nPGK7R5oo95v2F45az77fUB30ZB2Mtp4oae25ye5U3NU226Lwzuo4-ahOQNz63c7g%26u%3daHR0cHMlM2ElMmYlMmZ3d3cuYmVzdHByb2R1Y3RzcmV2aWV3cy5jby51ayUyZmJlc3QrY29mZmVlK21ha2VyJTNmbXNjbGtpZCUzZGEyYTQ0YzhjMzczZDFhNWYzY2Y2MjY1ZDQxYzk3YTVmJTI2dGFyZ2V0aWQlM2Rrd2QtODQ1OTUwNjYwMDQyNDklM2Fsb2MtNDA3NiUyNm1hdGNodHlwZSUzZGUlMjZkZXZpY2UlM2RjJTI2Y2FtcGFpZ25pZCUzZDUzMzE3NDQ4NSUyNmNyZWF0aXZlJTNkJTI2YWRncm91cGlkJTNkMTM1MzUwMTQ5ODExNTYzNyUyNmZlZWRpdGVtaWQlM2QlMjZsb2NfcGh5c2ljYWxfbXMlM2Q0MTQ3MSUyNmxvY19pbnRlcmVzdF9tcyUzZCUyNm5ldHdvcmslM2RvJTI2ZGV2aWNlbW9kZWwlM2QlMjZwbGFjZW1lbnQlM2QlMjZrZXl3b3JkJTNkJTI0YmVzdCUyNTIwY29mZmVlJTI1MjBtYWtlciUyNnRhcmdldCUzZCUyNmFkcG9zaXRpb24lM2QlMjZ0cmFja2lkJTNkdWtfYWxsX3RvcF9iaW5nJTI2bUlkJTNkSDE0OTAwM0NRTiUyNnV0bV9zb3VyY2UlM2RiZXN0cHJvZHVjdHNyZXZpZXdzLmNvLnVrJTdlYiUyNnV0bV9jYW1wYWlnbiUzZFltVnpkSEJ5YjJSMVkzUnpjbVYyYVdWM2N5NWpieTUxYTM1aSU3ZTUzMzE3NDQ4NSU3ZTEzNTM1MDE0OTgxMTU2MzclMjZjdHglM2RiJTdlYTJhNDRjOGMzNzNkMWE1ZjNjZjYyNjVkNDFjOTdhNWYlMjZ1dG1fbWVkaXVtJTNkY3BjJTI2dXRtX3Rlcm0lM2RiZXN0JTI1MjBjb2ZmZWUlMjUyMG1ha2VyJTI2dXRtX2NvbnRlbnQlM2RidXllcnNndWlkZS5vcmc%26rlid%3da2a44c8c373d1a5f3cf6265d41c97a5f/RK=2/RS=ypE7jh2NdqZ0RiGuT4S81GlLQCQ-;_ylt=A2RSU4z0dtFqCgMAH7BXNyoA;_ylu=Y29sbwNldS13ZXN0LTEEcG9zAzEEdnRpZAMEc2VjA292LWJvdHRvbQ--;_ylc=cnQDMQ--?IG=6452538cfa9244e1906ad176f4832747",
            "visual_url": "www.bestproductsreviews.co.uk",
            "domain": "www.bestproductsreviews.co.uk",
            "description": "Best coffee maker and other top-rated items for Home & Kitchen are reviewed by our experts. Find the right products that fit your budget and needs",
            "snippet": null,
            "sitelinks": []
        }
    ],
    "related_queries": [
        {
            "position": 1,
            "title": "best coffee maker with grinder",
            "url": "https://search.yahoo.com/search;_ylt=A2RSU4z0dtFqCgMAP7BXNyoA;_ylu=Y29sbwNldS13ZXN0LTEEcG9zAzEEdnRpZAMEc2VjA3JlbC1ib3Q-?p=best+coffee+maker+with+grinder&fr2=p%3As%2Cv%3Aw%2Cm%3Ars-bottom%2Cct%3Agossip"
        },
        {
            "position": 2,
            "title": "consumer reports best coffee maker",
            "url": "https://search.yahoo.com/search;_ylt=A2RSU4z0dtFqCgMAQ7BXNyoA;_ylu=Y29sbwNldS13ZXN0LTEEcG9zAzUEdnRpZAMEc2VjA3JlbC1ib3Q-?p=consumer+reports+best+coffee+maker&fr2=p%3As%2Cv%3Aw%2Cm%3Ars-bottom%2Cct%3Agossip"
        }
    ],
    "related_searches": [
        {
            "position": 1,
            "query": "best coffee maker with grinder",
            "link": "https://search.yahoo.com/search;_ylt=A2RSU4z0dtFqCgMAP7BXNyoA;_ylu=Y29sbwNldS13ZXN0LTEEcG9zAzEEdnRpZAMEc2VjA3JlbC1ib3Q-?p=best+coffee+maker+with+grinder&fr2=p%3As%2Cv%3Aw%2Cm%3Ars-bottom%2Cct%3Agossip",
            "type": "standard"
        },
        {
            "position": 2,
            "query": "consumer reports best coffee maker",
            "link": "https://search.yahoo.com/search;_ylt=A2RSU4z0dtFqCgMAQ7BXNyoA;_ylu=Y29sbwNldS13ZXN0LTEEcG9zAzUEdnRpZAMEc2VjA3JlbC1ib3Q-?p=consumer+reports+best+coffee+maker&fr2=p%3As%2Cv%3Aw%2Cm%3Ars-bottom%2Cct%3Agossip",
            "type": "standard"
        }
    ],
    "questions": [],
    "knowledge_graph": [],
    "local_results": [],
    "top_stories": [],
    "news_results": [],
    "images": [],
    "map_results": [],
    "hotel_results": [],
    "ai_overviews": []
}

Ads only

With search_type=ads the response has the same keys, with the ads filled in and the other lists empty. Each ad has its position, its landing page in url, and Yahoo's click URL in tracking_url. A page with no ads returns empty lists. Same price as a full search.

{
    "meta_data": {
        "url": "https://search.yahoo.com/search?p=best%20coffee%20maker",
        "number_of_results": null,
        "location": null,
        "number_of_organic_results": 0,
        "number_of_ads": 8,
        "number_of_page": 1,
        "zero_results_for_original_query": false
    },
    "organic_results": [],
    "top_ads": [
        {
            "position": 1,
            "title": "View The Best Best Coffee Maker of 2026 - One Standout Winner",
            "url": "https://www.bestproductsreviews.co.uk/best+coffee+maker?msclkid=92b918afd61e10ec0f24727ea0eaae73&targetid=kwd-84595066004249:loc-4076&matchtype=e&device=c&campaignid=533174485&creative=&adgroupid=1353501498115637&feeditemid=&loc_physical_ms=41471&loc_interest_ms=&network=o&devicemodel=&placement=&keyword=$best%20coffee%20maker&target=&adposition=&trackid=uk_all_top_bing&mId=H149003CQN&utm_source=bestproductsreviews.co.uk~b&utm_campaign=YmVzdHByb2R1Y3RzcmV2aWV3cy5jby51a35i~533174485~1353501498115637&ctx=b~92b918afd61e10ec0f24727ea0eaae73&utm_medium=cpc&utm_term=best%20coffee%20maker&utm_content=buyersguide.org",
            "tracking_url": "https://r.search.yahoo.com/rdclks/dWU9NGYzMWtlaGxkMnRuayZ1dD0xNzkyMTEyMzcyMjI2JnVvPTg0NTk0MjYyNDc1NzM2Jmx0PTImcz0xJmVzPVhjeDVVb1BzWUxYNDZxbWR0MWdPVkZwUFZEcEZOS0VWVmE5b0tLZ0VJdEY3eVQ4aTRHX1dFUWdGS1NjWktESXRHTm1xYUs1SlF6aF9zZ0Ut/RV=2/RE=1794704372/RO=14/RU=https%3a%2f%2fwww.bing.com%2faclick%3fld%3de8fmhwKqDd2bjhxYy64xWOUDVUCUxWfkIp19tCAnvLMOZEUFeacF3Yv8n5R9v9d68sLS7IPEgCNZjk6VgK0R-9Biq9ZsP7HWHK3TR_hN4V-W1tYNzzQQy0Ps2jXD8o-Lm8iy8_RZkte1qLwf9pDZiBTmmyU9T1fK1I6huUCyDk-tNYXRGmbfeAaLVWT6a3vn3sjIBKrg%26u%3daHR0cHMlM2ElMmYlMmZ3d3cuYmVzdHByb2R1Y3RzcmV2aWV3cy5jby51ayUyZmJlc3QrY29mZmVlK21ha2VyJTNmbXNjbGtpZCUzZDkyYjkxOGFmZDYxZTEwZWMwZjI0NzI3ZWEwZWFhZTczJTI2dGFyZ2V0aWQlM2Rrd2QtODQ1OTUwNjYwMDQyNDklM2Fsb2MtNDA3NiUyNm1hdGNodHlwZSUzZGUlMjZkZXZpY2UlM2RjJTI2Y2FtcGFpZ25pZCUzZDUzMzE3NDQ4NSUyNmNyZWF0aXZlJTNkJTI2YWRncm91cGlkJTNkMTM1MzUwMTQ5ODExNTYzNyUyNmZlZWRpdGVtaWQlM2QlMjZsb2NfcGh5c2ljYWxfbXMlM2Q0MTQ3MSUyNmxvY19pbnRlcmVzdF9tcyUzZCUyNm5ldHdvcmslM2RvJTI2ZGV2aWNlbW9kZWwlM2QlMjZwbGFjZW1lbnQlM2QlMjZrZXl3b3JkJTNkJTI0YmVzdCUyNTIwY29mZmVlJTI1MjBtYWtlciUyNnRhcmdldCUzZCUyNmFkcG9zaXRpb24lM2QlMjZ0cmFja2lkJTNkdWtfYWxsX3RvcF9iaW5nJTI2bUlkJTNkSDE0OTAwM0NRTiUyNnV0bV9zb3VyY2UlM2RiZXN0cHJvZHVjdHNyZXZpZXdzLmNvLnVrJTdlYiUyNnV0bV9jYW1wYWlnbiUzZFltVnpkSEJ5YjJSMVkzUnpjbVYyYVdWM2N5NWpieTUxYTM1aSU3ZTUzMzE3NDQ4NSU3ZTEzNTM1MDE0OTgxMTU2MzclMjZjdHglM2RiJTdlOTJiOTE4YWZkNjFlMTBlYzBmMjQ3MjdlYTBlYWFlNzMlMjZ1dG1fbWVkaXVtJTNkY3BjJTI2dXRtX3Rlcm0lM2RiZXN0JTI1MjBjb2ZmZWUlMjUyMG1ha2VyJTI2dXRtX2NvbnRlbnQlM2RidXllcnNndWlkZS5vcmc%26rlid%3d92b918afd61e10ec0f24727ea0eaae73/RK=2/RS=t7YtLXyV9porAVHEblJvJpR42nI-;_ylt=A2RSU4z0dtFqCgMA569XNyoA;_ylu=Y29sbwNldS13ZXN0LTEEcG9zAzEEdnRpZAMEc2VjA292LXRvcA--;_ylc=cnQDMQ--?IG=6452538cfa9244e1906ad176f4832747",
            "visual_url": "www.bestproductsreviews.co.uk",
            "domain": "www.bestproductsreviews.co.uk",
            "description": "Best coffee maker and other top-rated items for Home & Kitchen are reviewed by our experts. Find the right products that fit your budget and needs",
            "snippet": null,
            "sitelinks": []
        },
        {
            "position": 2,
            "title": "Coffee Makers 10 Best - Browse Coffee Makers 10 Best",
            "url": "https://www.amazon.co.uk/s/?ie=UTF8&keywords=coffee+makers+10+best&index=aps&tag=mh0a9-21&ref=pd_sl_9adnbl986j_e&adgrpid=1185275897005660&hvadid=74079975090616&hvnetw=o&hvqmt=e&hvbmt=be&hvdev=c&hvlocint=&hvlocphy=41471&hvtargid=kwd-74080511026300:loc-188&hydadcr=18485_2413083_3022&mcid=0b918df2ca7f30869878dd76a66c9163&hvocijid=13437815053114524526--&hvexpln=0&language=English&gb=2",
            "tracking_url": "https://r.search.yahoo.com/rdclks/dWU9NGYzMWtlaGxkMnRuayZ1dD0xNzkyMTEyMzcyMjI2JnVvPTc0MDc5OTc1MDkwNjE2Jmx0PTImcz0xJmVzPXlmTlBfYWI4aWZLcHpsWTRHbTFUb0dlN2twdmkwTzlSZHQwX1RsQ2EwSWZwMG5pVWgyZ1Y1SXJUUXZLUjRqQlowU0NyQnlEZjlWOW1TVm8t/RV=2/RE=1794704372/RO=14/RU=https%3a%2f%2fwww.bing.com%2faclick%3fld%3de8XB-d955_RTgQut_3WIwpCzVUCUyuuwop4v2qQJWkZ7iE-Ti1Rbw9C0Yl5Q5XpfRfS08AzxQ5_Q5WoNuUnivH_ADysJrhFIHbwvFPJZNfhO_PdzDa80gvWULevR0KejxFRyVJvyKKhYLhCDxqt2woMTx5Sqnpi3IDt0VvZFuknmMCls_pg7kx2Zxin1BUVkxQlKf1Rg%26u%3daHR0cHMlM2ElMmYlMmZ3d3cuYW1hem9uLmNvLnVrJTJmcyUyZiUzZmllJTNkVVRGOCUyNmtleXdvcmRzJTNkY29mZmVlJTJibWFrZXJzJTJiMTAlMmJiZXN0JTI2aW5kZXglM2RhcHMlMjZ0YWclM2RtaDBhOS0yMSUyNnJlZiUzZHBkX3NsXzlhZG5ibDk4NmpfZSUyNmFkZ3JwaWQlM2QxMTg1Mjc1ODk3MDA1NjYwJTI2aHZhZGlkJTNkNzQwNzk5NzUwOTA2MTYlMjZodm5ldHclM2RvJTI2aHZxbXQlM2RlJTI2aHZibXQlM2RiZSUyNmh2ZGV2JTNkYyUyNmh2bG9jaW50JTNkJTI2aHZsb2NwaHklM2Q0MTQ3MSUyNmh2dGFyZ2lkJTNka3dkLTc0MDgwNTExMDI2MzAwJTNhbG9jLTE4OCUyNmh5ZGFkY3IlM2QxODQ4NV8yNDEzMDgzXzMwMjIlMjZtY2lkJTNkMGI5MThkZjJjYTdmMzA4Njk4NzhkZDc2YTY2YzkxNjMlMjZodm9jaWppZCUzZDEzNDM3ODE1MDUzMTE0NTI0NTI2LS0lMjZodmV4cGxuJTNkMCUyNmxhbmd1YWdlJTNkRW5nbGlzaCUyNmdiJTNkMg%26rlid%3decde3bec72cc1cd071a8513d0438b7ae/RK=2/RS=uYeJgWfDMI09oNmkEhbW.FbDv_4-;_ylt=A2RSU4z0dtFqCgMA7a9XNyoA;_ylu=Y29sbwNldS13ZXN0LTEEcG9zAzIEdnRpZAMEc2VjA292LXRvcA--;_ylc=cnQDMQ--?IG=6452538cfa9244e1906ad176f4832747",
            "visual_url": "www.amazon.co.uk",
            "domain": "www.amazon.co.uk",
            "description": "Find deals and compare prices on Coffee Makers 10 Best. Read customer reviews & find bestsellers. Easy returns on millions of items.",
            "snippet": null,
            "sitelinks": []
        }
    ],
    "bottom_ads": [
        {
            "position": 1,
            "title": "View The Best Best Coffee Maker of 2026 - One Standout Winner",
            "url": "https://www.bestproductsreviews.co.uk/best+coffee+maker?msclkid=a2a44c8c373d1a5f3cf6265d41c97a5f&targetid=kwd-84595066004249:loc-4076&matchtype=e&device=c&campaignid=533174485&creative=&adgroupid=1353501498115637&feeditemid=&loc_physical_ms=41471&loc_interest_ms=&network=o&devicemodel=&placement=&keyword=$best%20coffee%20maker&target=&adposition=&trackid=uk_all_top_bing&mId=H149003CQN&utm_source=bestproductsreviews.co.uk~b&utm_campaign=YmVzdHByb2R1Y3RzcmV2aWV3cy5jby51a35i~533174485~1353501498115637&ctx=b~a2a44c8c373d1a5f3cf6265d41c97a5f&utm_medium=cpc&utm_term=best%20coffee%20maker&utm_content=buyersguide.org",
            "tracking_url": "https://r.search.yahoo.com/rdclks/dWU9NGYzMWtlaGxkMnRuayZ1dD0xNzkyMTEyMzcyMjI2JnVvPTg0NTk0MjYyNDc1NzM2Jmx0PTImcz0xJmVzPWVGX2NPM3BaRWVOWkRuRzBTbEoxbUZpVWlwbnBmM18wWXdiN3VfXzQ2UlVFUHlKeVd3Qkx6ODFfVzFIZ1NWMjFVSkVpUm0xclViNXNEYWst/RV=2/RE=1794704372/RO=14/RU=https%3a%2f%2fwww.bing.com%2faclick%3fld%3de8XW66UKPVP6TNN4YA6KyawDVUCUzLeLY5a6N1-1__QzrEC6qdrqhRgRDDzrejOUkXXvP1cXzRA48OHCP0Yk-I-Ib7B_nneRSzgR6QFfWMaZtMYjVf0ghfFHATxYN_QRBaWh7E6nPGK7R5oo95v2F45az77fUB30ZB2Mtp4oae25ye5U3NU226Lwzuo4-ahOQNz63c7g%26u%3daHR0cHMlM2ElMmYlMmZ3d3cuYmVzdHByb2R1Y3RzcmV2aWV3cy5jby51ayUyZmJlc3QrY29mZmVlK21ha2VyJTNmbXNjbGtpZCUzZGEyYTQ0YzhjMzczZDFhNWYzY2Y2MjY1ZDQxYzk3YTVmJTI2dGFyZ2V0aWQlM2Rrd2QtODQ1OTUwNjYwMDQyNDklM2Fsb2MtNDA3NiUyNm1hdGNodHlwZSUzZGUlMjZkZXZpY2UlM2RjJTI2Y2FtcGFpZ25pZCUzZDUzMzE3NDQ4NSUyNmNyZWF0aXZlJTNkJTI2YWRncm91cGlkJTNkMTM1MzUwMTQ5ODExNTYzNyUyNmZlZWRpdGVtaWQlM2QlMjZsb2NfcGh5c2ljYWxfbXMlM2Q0MTQ3MSUyNmxvY19pbnRlcmVzdF9tcyUzZCUyNm5ldHdvcmslM2RvJTI2ZGV2aWNlbW9kZWwlM2QlMjZwbGFjZW1lbnQlM2QlMjZrZXl3b3JkJTNkJTI0YmVzdCUyNTIwY29mZmVlJTI1MjBtYWtlciUyNnRhcmdldCUzZCUyNmFkcG9zaXRpb24lM2QlMjZ0cmFja2lkJTNkdWtfYWxsX3RvcF9iaW5nJTI2bUlkJTNkSDE0OTAwM0NRTiUyNnV0bV9zb3VyY2UlM2RiZXN0cHJvZHVjdHNyZXZpZXdzLmNvLnVrJTdlYiUyNnV0bV9jYW1wYWlnbiUzZFltVnpkSEJ5YjJSMVkzUnpjbVYyYVdWM2N5NWpieTUxYTM1aSU3ZTUzMzE3NDQ4NSU3ZTEzNTM1MDE0OTgxMTU2MzclMjZjdHglM2RiJTdlYTJhNDRjOGMzNzNkMWE1ZjNjZjYyNjVkNDFjOTdhNWYlMjZ1dG1fbWVkaXVtJTNkY3BjJTI2dXRtX3Rlcm0lM2RiZXN0JTI1MjBjb2ZmZWUlMjUyMG1ha2VyJTI2dXRtX2NvbnRlbnQlM2RidXllcnNndWlkZS5vcmc%26rlid%3da2a44c8c373d1a5f3cf6265d41c97a5f/RK=2/RS=ypE7jh2NdqZ0RiGuT4S81GlLQCQ-;_ylt=A2RSU4z0dtFqCgMAH7BXNyoA;_ylu=Y29sbwNldS13ZXN0LTEEcG9zAzEEdnRpZAMEc2VjA292LWJvdHRvbQ--;_ylc=cnQDMQ--?IG=6452538cfa9244e1906ad176f4832747",
            "visual_url": "www.bestproductsreviews.co.uk",
            "domain": "www.bestproductsreviews.co.uk",
            "description": "Best coffee maker and other top-rated items for Home & Kitchen are reviewed by our experts. Find the right products that fit your budget and needs",
            "snippet": null,
            "sitelinks": []
        },
        {
            "position": 2,
            "title": "Top 7 coffee machines 2026 - Best coffee machines 2026",
            "url": "https://www.finalcheck.co.uk/coffee-machine/?channel=bing&device=c&network=o&campaign=439420907&adgroup=1167682481248700&target=kwd-72980831005038:loc-188&ad=72980381746308&ad-extension=&location=41471&campaign-type=product&item=&msclkid=f82cb2005ee91efe7e9fd8d1281d6e79",
            "tracking_url": "https://r.search.yahoo.com/rdclks/dWU9NGYzMWtlaGxkMnRuayZ1dD0xNzkyMTEyMzcyMjI2JnVvPTcyOTgwMzgxNzQ2MzA4Jmx0PTImcz0xJmVzPUFtcl9UeDFIdW84WTRpNHVLWDhzd3VpZUF4YzhSTU9Ta0lWOXNCVGY3Znc0eWl1elRJdWdhRWRpVERQaVpmV1QwZUVsY29WMEJja2xjNzQt/RV=2/RE=1794704372/RO=14/RU=https%3a%2f%2fwww.bing.com%2faclick%3fld%3de80YZQM4u-ZecHzRntOrZ_ojVUCUzLbxcJy1Oezrwfi3hgBDuM9dF8bheQURhiNRJ1x_eN7sG8E5jB_ehMPyJ2etWv2c2d8gADkKI0W_yRbp-m9_QPiyvlMUCmCi23CWjE1nXYwvGwHXuuXotaYf2yI-17P8wRo6mjYAHLmtsUAcfjPwHtBf9DX-zfWY_ZmDWjSZrdzQ%26u%3daHR0cHMlM2ElMmYlMmZ3d3cuZmluYWxjaGVjay5jby51ayUyZmNvZmZlZS1tYWNoaW5lJTJmJTNmY2hhbm5lbCUzZGJpbmclMjZkZXZpY2UlM2RjJTI2bmV0d29yayUzZG8lMjZjYW1wYWlnbiUzZDQzOTQyMDkwNyUyNmFkZ3JvdXAlM2QxMTY3NjgyNDgxMjQ4NzAwJTI2dGFyZ2V0JTNka3dkLTcyOTgwODMxMDA1MDM4JTNhbG9jLTE4OCUyNmFkJTNkNzI5ODAzODE3NDYzMDglMjZhZC1leHRlbnNpb24lM2QlMjZsb2NhdGlvbiUzZDQxNDcxJTI2Y2FtcGFpZ24tdHlwZSUzZHByb2R1Y3QlMjZpdGVtJTNkJTI2bXNjbGtpZCUzZGY4MmNiMjAwNWVlOTFlZmU3ZTlmZDhkMTI4MWQ2ZTc5%26rlid%3df82cb2005ee91efe7e9fd8d1281d6e79/RK=2/RS=M7SMsy.EWz.NAGT1H7xJ1CbBBMo-;_ylt=A2RSU4z0dtFqCgMAJ7BXNyoA;_ylu=Y29sbwNldS13ZXN0LTEEcG9zAzIEdnRpZAMEc2VjA292LWJvdHRvbQ--;_ylc=cnQDMQ--?IG=6452538cfa9244e1906ad176f4832747",
            "visual_url": "www.finalcheck.co.uk",
            "domain": "www.finalcheck.co.uk",
            "description": "Find the best coffee machines with detailed comparisons & ratings at finalcheck. There's nothing like a hot cup of coffee in the morning. Order now.",
            "snippet": null,
            "sitelinks": []
        }
    ]
}

Questions

Is it compatible with ScrapingBee?

ScrapingBee has no Yahoo endpoint. This one takes the parameters of their Google Search API and returns the same response shape, so code written for one works for the other.

What does a search cost?

10 credits for a light request (the default) and 15 for a regular one. An ads-only search costs the same. Credits come from your plan's monthly allowance, or from the free credit balance.

Do failed searches cost credits?

No. A search Yahoo blocks, one that times out, or one that returns a page that is not a results page is never billed. A blocked search is retried on another exit first, up to three times.

Which countries can I search from?

9 right now: United States, Australia, Brazil, Canada, Germany, Italy, South Korea, Spain, United Kingdom. Set country_code; a country we cannot search from is refused rather than answered from somewhere else.

Why does it need the robots.txt opt-out?

Yahoo's robots.txt disallows automated access to its result pages, and webfetch honors robots.txt unless you turn the opt-out on in your key portal. Turning it on records your acceptance of the acceptable use policy. Paid plans turn it on themselves; free accounts request it in the key portal, and a person approves each request.

Google Search API
Bing Search API
Search API overview
Yahoo search tool, with JSON and CSV export
Search API reference: errors, headers and every option
Pricing and how webfetch compares with ScrapingBee