Bing Reverse Image API documentation for developers who need to find where an image appears. Scrappa's GET /api/bing/reverse-image endpoint runs a Bing search by image for a public image URL and returns a best guess and about 10 matching web pages.
How to call the endpoint
Send a GET request with a required image_url and your API key in the x-api-key header. The URL must start with http:// or https:// and point to a public host. Bing downloads the image itself. Private, local and internal addresses are refused with a 422 error.
Response fields
best_guess is the text Bing names for the image. data lists web results with position, title, url, source (site name), display_url, snippet and favicon. The request has no paging.
Limits
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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
3 optional filters available.
string
Required
Public http or https URL of the image. Use a direct link to a JPEG, PNG or WebP file.
Example: https://www.python.org/static/img/python-logo.png
example
string
Optional
Bing market, language and region together, for example de-DE or en-GB. Use the same market as the shopping search that gave you the token.
Default: en-US
example
string
Optional
Two-letter country code, for example DE. Scrappa sends it together with mkt.
Default: the country of mkt
example
string
Optional
Interface language, for example de. Scrappa sends it together with mkt.
Default: the language of mkt
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
market
source
image_url
best_guess
results_on_page
Common data fields
url
title
source
favicon
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
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.
{
"errors": {
"image_url": [
"The image url must point to a public host."
]
},
"message": "The request validation failed"
}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.
{
"error": "Bing could not fetch or read this image. Use another publicly reachable image URL.",
"retryable": false,
"error_code": "bing_image_unreachable"
}Bing Temporarily Unavailable
Bing did not return usable data after the bounded retry on another route. The request is not billed. Retry shortly.
{
"error": "Bing upstream is temporarily unavailable. Please retry shortly.",
"service": "BingReverseImageService",
"retryable": true,
"error_code": "bing_upstream_unavailable",
"failed_stage": "upstream_request"
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.