JSON POST request example
POST to https://api.litescrape.com/api/yahoo/images with Content-Type: application/json and your Authorization: Bearer header.
{
"p": "coffee",
"yahoo_domain": "search.yahoo.com",
"b": 1
}// request reference
Yahoo Images parameters
Send query parameters with GET /api/yahoo/images. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Search
Query, localization and pagination.
pText or search operators to send to Yahoo.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 2000
yahoo_domainYahoo regional search host, for example fr.search.yahoo.com. A regional prefix such as fr is also accepted.
Type string · GET query or POST JSON · Default search.yahoo.com
bOne-based starting result. Web pages usually advance by 10; image pages usually advance by 60.
Type integer · GET query or POST JSON · Default 1
- Minimum: 1
- Maximum: 10001
deviceDevice profile used for the Yahoo result page.
Type string · GET query or POST JSON · Default desktop
desktoptabletmobileFilters
Narrow the Yahoo result set.
imgszImage size category; wallpaper selects extra-large images.
Type string · GET query or POST JSON
smallmediumlargewallpaperimgcSelect color images, monochrome images (bw), or a dominant color.
Type string · GET query or POST JSON
colorbwredorangeyellowgreentealbluepurplepinkbrownblackgraywhiteimgtyImage style or format to include.
Type string · GET query or POST JSON
photoclipartlinedrawinggiftransparentimgaImage shape: square, landscape (wide), or portrait (tall).
Type string · GET query or POST JSON
squarewidetallimgfPeople filter: faces, head-and-shoulders portraits, or images without people.
Type string · GET query or POST JSON
faceportraitnonportraitimgtLimit images to a recent day, week, month, or year.
Type string · GET query or POST JSON
dayweekmonthyearimglUsage-rights category: Creative Commons (cc), public domain (pd), sharing (fsu), commercial sharing (fsuc), modification (fmsu), or commercial modification (fmsuc).
Type string · GET query or POST JSON
ccpdfsufsucfmsufmsuc// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_metadata, search_parameters, images_results, related_searches, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.
Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.
Illustrative success response. Result groups and optional fields depend on upstream content.
{
"images_results": [
{
"position": 1,
"link": "https://images.search.yahoo.com/search/images;_ylt=A2RRBVqHyslq0wIAJc.JzbkF;_ylu=Y29sbwN1cy1lYXN0LTEEcG9zAzEEdnRpZAMEc2VjA3Ny?p=coffee&imgurl=https%3A%2F%2Fstatic.vecteezy.com%2Fsystem%2Fresources%2Fpreviews%2F023%2F920%2F415%2Fnon_2x%2Fcoffee-beans-close-up-photo.jpg",
"original": "https://static.vecteezy.com/system/resources/previews/023/920/415/non_2x/coffee-beans-close-up-photo.jpg",
"title": "Coffee beans close-up 23920415 Stock Photo at Vecteezy",
"source": "https://www.vecteezy.com/photo/23920415-coffee-beans-close-up",
"thumbnail": "https://tse1.mm.bing.net/th/id/OIP.lGSXWR1Fwmurem6DorIzvwHaE8?r=0&pid=Api&h=220&P=0",
"original_width": 1470,
"original_height": 980
},
{
"position": 2,
"link": "https://images.search.yahoo.com/search/images;_ylt=A2RRBVqHyslq0wIAJ8.JzbkF;_ylu=Y29sbwN1cy1lYXN0LTEEcG9zAzIEdnRpZAMEc2VjA3Ny?p=coffee&imgurl=https%3A%2F%2Fimages.pexels.com%2Fphotos%2F4815951%2Fpexels-photo-4815951.jpeg%3Fcs%3Dsrgb%26dl%3Dpexels-maksgelatin-4815951.jpg%26fm%3Djpg",
"original": "https://images.pexels.com/photos/4815951/pexels-photo-4815951.jpeg?cs=srgb&dl=pexels-maksgelatin-4815951.jpg&fm=jpg",
"title": "Coffee Beans in Close Up Photography · Free Stock Photo",
"source": "https://www.pexels.com/photo/coffee-beans-in-close-up-photography-4109744/",
"thumbnail": "https://tse3.mm.bing.net/th/id/OIP.JNJgI2MMi5g3QBEvhEidegHaE8?r=0&pid=Api&h=220&P=0",
"original_width": 6718,
"original_height": 4479
}
],
"search_parameters": {
"p": "coffee",
"yahoo_domain": "search.yahoo.com",
"b": 1,
"device": "desktop"
},
"search_metadata": {
"provider_url": "https://images.search.yahoo.com/search/images?p=coffee&b=1&ei=UTF-8",
"total_time_taken": 1
},
"pagination": {
"current": 1
},
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}