# Bing Reverse Image API

<p><strong>Bing Reverse Image API documentation</strong> for developers who need to find where an image appears. Scrappa's <code>GET /api/bing/reverse-image</code> endpoint runs a Bing search by image for a public image URL and returns a best guess and about 10 matching web pages.</p><h2>How to call the endpoint</h2><p>Send a <code>GET</code> request with a required <code>image_url</code> and your API key in the <code>x-api-key</code> header. The URL must start with <code>http://</code> or <code>https://</code> and point to a public host. Bing downloads the image itself. Private, local and internal addresses are refused with a 422 error.</p><h2>Response fields</h2><p><code>best_guess</code> is the text Bing names for the image. <code>data</code> lists web results with <code>position</code>, <code>title</code>, <code>url</code>, <code>source</code> (site name), <code>display_url</code>, <code>snippet</code> and <code>favicon</code>. The request has no paging.</p><h2>Limits</h2><p>Bing must be able to fetch and read the image. Some hosts and formats, for example SVG files and some wiki thumbnails, are refused by Bing. The endpoint then returns 422 and the request is not billed. Visual match tiles are not included.</p>

- **Documentation:** [https://scrappa.co/docs/bing-search-api/bing_reverse_image](https://scrappa.co/docs/bing-search-api/bing_reverse_image)
- **API group:** Bing Search API
- **Endpoint:** `GET https://scrappa.co/api/bing/reverse-image`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `image_url` | string | Yes | <p>Public <code>http</code> or <code>https</code> URL of the image. Use a direct link to a JPEG, PNG or WebP file.</p><p><strong>Example:</strong> <code>https://www.python.org/static/img/python-logo.png</code></p> |
| `mkt` | string | No | <p>Bing market, language and region together, for example <code>de-DE</code> or <code>en-GB</code>. Use the same market as the shopping search that gave you the token.</p><p><strong>Default:</strong> <code>en-US</code></p> |
| `cc` | string | No | <p>Two-letter country code, for example <code>DE</code>. Scrappa sends it together with <code>mkt</code>.</p><p><strong>Default:</strong> the country of <code>mkt</code></p> |
| `setlang` | string | No | <p>Interface language, for example <code>de</code>. Scrappa sends it together with <code>mkt</code>.</p><p><strong>Default:</strong> the language of <code>mkt</code></p> |

## Example response

```json
{
    "data": [
        {
            "url": "https://www.python.org/",
            "title": "Welcome to Python.org",
            "source": "Python.org",
            "favicon": "https://th.bing.com/th/id/ODF.SWId9aBgwQh4GYX8Nki9BA?w=32&h=32&qlt=90&pcl=fffffa&o=6&pid=1.2",
            "snippet": "The official home of the Python Programming Language.",
            "position": 1,
            "display_url": "https://www.python.org"
        },
        {
            "url": "https://en.wikipedia.org/wiki/Python_(programming_language)",
            "title": "Python (programming language) - Wikipedia",
            "source": "Wikipedia",
            "favicon": "https://th.bing.com/th/id/ODF.INhCOd4qElPoejfhZYl17A?w=32&h=32&qlt=91&pcl=fffffa&o=6&pid=1.2",
            "snippet": "Python is a high-level, general-purpose programming language that emphasizes code readability, simplicity, and ease-of-writing.",
            "position": 2,
            "display_url": "https://en.wikipedia.org \u203a wiki \u203a Python_(programming_language)"
        }
    ],
    "market": {
        "cc": "US",
        "mkt": "en-US",
        "setlang": "en"
    },
    "source": "bing",
    "image_url": "https://www.python.org/static/img/python-logo.png",
    "best_guess": "Python Programming Language",
    "results_on_page": 2
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The image_url is missing, is not a public http or https URL, points to a private or local address, or mkt, cc or setlang is malformed. |
| 422 | Image Not Readable | Bing could not fetch or read the image, for example a blocked host or an SVG file. Use another public image URL. The request is not billed. |
| 503 | Bing Temporarily Unavailable | Bing did not return usable data after the bounded retry on another route. The request is not billed. Retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)