Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

← All documentation

// Yahoo documentation

Yahoo Images API

Yahoo image results with size, color, style, shape, people, date and usage-rights filters.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/yahoo/images

// from request to code

Integrate Yahoo Images

Build your request and copy it into your stack. Or let your coding agent set it up.

APIYahoo Images
More options 10
Search

Query, localization and pagination.

Filters

Narrow the Yahoo result set.

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --get 'https://ecll-litescrape-v3--site-api-web.modal.run/api/yahoo/images' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --data-urlencode 'p=coffee' \
  --data-urlencode 'yahoo_domain=search.yahoo.com' \
  --data-urlencode 'b=1'

Read all parameters →

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/yahoo/images with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "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.

p
QueryRequired

Text or search operators to send to Yahoo.

Type string · GET query or POST JSON

  • Minimum characters: 1
  • Maximum characters: 2000
yahoo_domain
Yahoo domainOptional

Yahoo 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

b
Starting resultOptional

One-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
device
DeviceOptional

Device profile used for the Yahoo result page.

Type string · GET query or POST JSON · Default desktop

Accepted valuesdesktoptabletmobile

Filters

Narrow the Yahoo result set.

imgsz
Image sizeOptional

Image size category; wallpaper selects extra-large images.

Type string · GET query or POST JSON

Accepted valuessmallmediumlargewallpaper
imgc
Image colorOptional

Select color images, monochrome images (bw), or a dominant color.

Type string · GET query or POST JSON

Accepted valuescolorbwredorangeyellowgreentealbluepurplepinkbrownblackgraywhite
imgty
Image typeOptional

Image style or format to include.

Type string · GET query or POST JSON

Accepted valuesphotoclipartlinedrawinggiftransparent
imga
Image shapeOptional

Image shape: square, landscape (wide), or portrait (tall).

Type string · GET query or POST JSON

Accepted valuessquarewidetall
imgf
People filterOptional

People filter: faces, head-and-shoulders portraits, or images without people.

Type string · GET query or POST JSON

Accepted valuesfaceportraitnonportrait
imgt
Image recencyOptional

Limit images to a recent day, week, month, or year.

Type string · GET query or POST JSON

Accepted valuesdayweekmonthyear
imgl
Usage rightsOptional

Usage-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

Accepted valuesccpdfsufsucfmsufmsuc

// 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.

200 · application/json
{
  "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"
}

More Yahoo APIs