# Yahoo Image API (/docs/yahoo-apis/yahoo-image-api)





Fetch real-time image search results from Yahoo, enabling seamless access to images from a wide range of online sources.

<Callout type="warn">
  Requires authentication → provide your API key as a Bearer token in the
  Authorization header.
</Callout>

`POST` `https://api.serphouse.com/yahoo-image`

<Callout type="info" title="Response types">
  These are the response types we support. Append a suffix to the endpoint to
  choose the response format.
</Callout>

| Format         | Endpoint                                     |
| -------------- | -------------------------------------------- |
| JSON (default) | `https://api.serphouse.com/yahoo-image`      |
| Markdown       | `https://api.serphouse.com/yahoo-image/md`   |
| HTML           | `https://api.serphouse.com/yahoo-image/html` |

## Headers [#headers]

| Name                                                           | Type   | Description             |
| -------------------------------------------------------------- | ------ | ----------------------- |
| Authorization <span style="{color: &#x22;red&#x22;}">\*</span> | String | Bearer `<YOUR_API_KEY>` |
| Content-Type <span style="{color: &#x22;red&#x22;}">\*</span>  | String | application/json        |

## Request Body [#request-body]

| Name                                                    | Type              | Description                                                                                                                                                                                         |
| ------------------------------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| q <span style="{color: &#x22;red&#x22;}">\*</span>      | string            | Search phrase that you want to search                                                                                                                                                               |
| domain <span style="{color: &#x22;red&#x22;}">\*</span> | string            | Choose yahoo domain (e.g. `in.yahoo.com`).<br /><br />You can retrieve the list of supported Yahoo domains by making a separate request to the [Domains List](/extra-apis/domains-list)             |
| lang <span style="{color: &#x22;red&#x22;}">\*</span>   | string            | You can set language for e.g. `lang_en` for english `lang_fr` for french.<br />Get the list of available languages by making a separate request to the [Languages List](/extra-apis/languages-list) |
| page                                                    | integer           | Give specific page to get the result of that page number. By default it will get you first page.                                                                                                    |
| no\_trace                                               | string \| integer | Enterprise only. Enables NoTrace mode. Accepted values: `0`, `1`, `true`, and `false`. When enabled (`1` or `true`), search parameters, files, and metadata are not stored on our servers.          |

<Callout type="info">
  Yahoo requires regional domains → browse the [Domains
  List](/extra-apis/domains-list) to find the right domain for your target
  region. <code>yahoo.com</code> is not valid.
</Callout>

<VisualRef title="Yahoo Image API" src="/images/yahoo/yahoo-image-api.png" alt="Yahoo image search results" />

## Example Request [#example-request]

<ApiExample endpoint="https://api.serphouse.com/yahoo-image" query="sunset beach" domain="de.yahoo.com" lang="lang_en" params="{&#x22;page&#x22;: 1}" />

## Example Response [#example-response]

<ApiExample mode="response">
  <ApiTab label="JSON" response="yahooImageJsonResponse" />

  <ApiTab label="Markdown" response="yahooImageMarkdownResponse" lang="markdown" />
</ApiExample>

## Related Links [#related-links]

<Cards>
  <Card title="Yahoo Search API" href="/yahoo-apis/yahoo-search" />

  <Card title="Yahoo News API" href="/yahoo-apis/yahoo-news-api" />
</Cards>