Yahoo Search API

The Autom Yahoo Search API returns Yahoo organic results as structured JSON, with country (gl) and language (hl) options.

• Yahoo Search API — Query Yahoo via API and retrieve structured organic results with country and language.

Use it for rank tracking on Yahoo, SEO research or LLM grounding.

Endpoint	Request	Credits
Yahoo Search API	GET /v1/yahoo/search	1

Table of contents

• How it works
• Yahoo Search API
• Code examples in other languages
• Use cases
• Why Autom?
• FAQ
• Official SDKs
• Related repositories
• Support

How it works

1. Create a Autom account and copy your API key from the dashboard.
2. Call https://api.autom.dev with the header x-api-key: YOUR_API_KEY.
3. Use the result in your app — no infrastructure to run.

export AUTOM_API_KEY="your-api-key"
pip install requests        # Python
# TypeScript: Node.js 18+ (native fetch), run with `npx tsx file.ts`

Yahoo Search API

Query Yahoo via API and retrieve structured organic results with country and language.

GET https://api.autom.dev/v1/yahoo/search · 1 credit per request · API reference

Request parameters

Parameter	In	Type	Required	Description
query	query	string	✅	Search query sent to Yahoo Search.
page	query	number	—	Page number. Page 1 is the first page of results.
gl	query	string	—	Country code, for example us, fr, gb, de, jp.
hl	query	string	—	Language code, for example en, fr, de, ja, zh.

Python example

import os

import requests

API_KEY = os.environ["AUTOM_API_KEY"]
HEADERS = {"x-api-key": API_KEY}

response = requests.get(
    "https://api.autom.dev/v1/yahoo/search",
    headers=HEADERS,
    params={
        "query": "openai",
    },
    timeout=120,
)
response.raise_for_status()

data = response.json()
print(data)

TypeScript example

type YahooSearchApi = {
  organic_results?: {
    link?: string;
    title?: string;
    domain?: string;
    snippet?: string;
    position?: number;
    displayed_link?: string;
  }[];
  search_parameters?: {
    q?: string;
    gl?: string;
    hl?: string;
    page?: number;
    engine?: string;
  };
};

const headers = { "x-api-key": process.env.AUTOM_API_KEY!, "Content-Type": "application/json" };

const params = new URLSearchParams({
  "query": "openai",
});

const response = await fetch(`https://api.autom.dev/v1/yahoo/search?${params}`, { headers });
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);

const data = (await response.json()) as YahooSearchApi;
console.log(data);

Output example

Example response from the API reference, abridged.

{
  "organic_results": [
    {
      "link": "https://openai.com/",
      "title": "OpenAI",
      "domain": "openai.com",
      "snippet": "OpenAI is an AI research and deployment company.",
      "position": 1,
      "displayed_link": "https://openai.com"
    }
  ],
  "search_parameters": {
    "q": "openai",
    "gl": "us",
    "hl": "en",
    "page": 1,
    "engine": "yahoo"
  }
}

Response fields

Field	Type	Description
organic_results[]	object[]
organic_results[].link	string
organic_results[].title	string
organic_results[].domain	string
organic_results[].snippet	string
organic_results[].position	integer
organic_results[].displayed_link	string
search_parameters	object
search_parameters.q	string
search_parameters.gl	string
search_parameters.hl	string
search_parameters.page	integer
search_parameters.engine	string

Code examples in other languages

Ready-to-run examples live in examples/; each reads your key from AUTOM_API_KEY.

Language	yahoo-search
cURL (Bash)	yahoo_search.sh
PHP	yahoo_search.php
C#	YahooSearch.cs
Go	yahoo_search.go
Java	YahooSearchExample.java
Ruby	yahoo_search.rb
Node.js	yahoo_search.mjs

Use cases

• Rank tracking — Track positions on Yahoo.
• LLM grounding — Feed agents with fresh results.

Why Autom?

• Every SERP in one API — Google Search, AI Mode, Maps, News, Shopping, Images, Videos, Jobs, Autocomplete, plus Bing and Brave.
• Structured JSON — documented fields instead of brittle HTML parsing.
• Geo & language targeting — search like a user from the country and language you need.
• One API key, one header — x-api-key on every request.
• Copy-paste examples — Python and TypeScript in each README, 7 more languages in examples/.

FAQ

How do I authenticate?

Create an account on Autom, copy your API key and send it in the x-api-key header of every request to https://api.autom.dev.

How much does a request cost?

Credits per call: /v1/yahoo/search 1. See Autom pricing.

Which languages are supported?

Any language that can make an HTTP request. This README shows Python and TypeScript; the examples/ folder contains cURL, PHP, C#, Go, Java, Ruby and Node.js.

Official SDKs

Use Autom from your own language with a typed client:

SDK	Package	Install
Node.js	@automdev/sdk	npm install @automdev/sdk
Python	automdev	pip install automdev
Go	autom-go	go get github.com/automdev/autom-go
.NET	Autom	dotnet add package Autom
Ruby	autom	gem install autom
PHP	autom/sdk	composer require autom/sdk
Java	autom-java	build from source, see its README
CLI	@automdev/cli	npm install -g @automdev/cli
MCP server	@automdev/mcp	npx -y @automdev/mcp

Related repositories

• Google Search API
• Google AI Mode API
• Google Maps API
• Google News API
• Google Shopping API
• Google Images API
• Google Videos API
• Google Jobs API
• All Autom repositories

Support

• 💬 Join the Discord to ask questions and share what you build.
• 📚 Read the API reference.
• 🔑 Get your API key.

---

_{Built by Autom. Examples are released under the MIT license.}