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

// Apple App Store documentation

Apple App Store Search API

Apple App Store search, up to 200 iPhone, iPad or Mac apps with developer, price, rating, genres, version, screenshots and devices, across 175 storefronts.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/apple/app-store/search

// from request to code

Integrate Apple App Store Search

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

APIApple App Store Search
More options 7
Request
Filters
Localization

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/apple/app-store/search' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --data-urlencode 'term=coffee'

Read all parameters →

JSON POST request example

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

POST · application/json
{
  "term": "coffee",
  "num": 3
}

// request reference

Apple App Store Search parameters

Send query parameters with GET /api/apple/app-store/search. 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.

Request

term
Search termRequired

Search term with 1 to 2,048 UTF-8 bytes of printable text, and at most 4,096 bytes after URL encoding.

Type string · GET query or POST JSON

Example / input hint: coffee

  • Minimum characters: 1
  • Maximum characters: 2048
num
Result countOptional

Maximum results after filtering, from 1 through 200.

Type integer · GET query or POST JSON · Default 10

Example / input hint: 10

  • Minimum: 1
  • Maximum: 200

Filters

disallow_explicit
Exclude explicit appsOptional

Exclude explicit results when true.

Type boolean · GET query or POST JSON · Default false

Example / input hint: false

Accepted valuestruefalse
property
Search propertyOptional

Use developer to match developer names, ignoring case.

Type string · GET query or POST JSON

Accepted valuesdeveloper
category_id
Category IDOptional

Filter results by a native genre identifier, from 1 through 2,147,483,647.

Type integer · GET query or POST JSON

  • Minimum: 1
  • Maximum: 2147483647
device
App platformOptional

mobile for iPhone apps, tablet for iPad apps, or desktop for Mac apps.

Type string · GET query or POST JSON · Default mobile

Example / input hint: mobile

Accepted valuesmobiletabletdesktop

Localization

country
CountryOptional

Two-letter Apple storefront country. UK is accepted as an alias for GB.

Type string · GET query or POST JSON · Default us

Example / input hint: us

  • Pattern: ^[a-zA-Z]{2}$
lang
LanguageOptional

Language-region code, such as en-us or fr-fr.

Type string · GET query or POST JSON · Default en-us

Example / input hint: en-us

  • Pattern: ^[a-zA-Z]{2,3}-[a-zA-Z]{2}$

// 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 organic_results, search_information, search_metadata, search_parameters, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

The SDK examples use raise_for_error() or raiseForError() so API errors are not mistaken for successful results.

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
{
  "organic_results": [
    {
      "age_rating": "4+",
      "bundle_id": "com.tapblaze.coffeebusiness",
      "description": "Wake up and smell the coffee because TapBlaze's newest simulation cooking game, Good Coffee, Great Coffee, is finally here! Prepare delicious drinks, experiment with new flavors, decorate your shop, and manage cafe costs to become the best barista in town!\n\nFulfill quirky customer orders with coffee drinks that look and taste delicious! Upgrade your shop with new decorations and equipment to increase your cafe profit! Make friends, rivals, and more when locals visit your shop! Listen to their stories and inspire the town with your coffee-making skills!\n\nDownload the game now to become the next ?",
      "developer": {
        "id": 1055223695,
        "link": "https://apps.apple.com/us/developer/tapblaze/id1055223695?uo=4",
        "name": "TAPBLAZE"
      },
      "features": [
        "gameCenter",
        "iosUniversal"
      ],
      "game_center_enabled": true,
      "genres": [
        {
          "id": 6014,
          "name": "Games",
          "primary": true
        },
        {
          "id": 7003,
          "name": "Casual",
          "primary": false
        }
      ],
      "id": 1603584945,
      "latest_version_release_date": "2026-09-03 19:45:12 UTC",
      "link": "https://apps.apple.com/us/app/good-coffee-great-coffee/id1603584945?uo=4",
      "logos": [
        {
          "link": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/2d/f9/59/2df95934-332f-d621-eba1-27fc3c67f49c/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/60x60bb.jpg",
          "size": "60x60"
        },
        {
          "link": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/2d/f9/59/2df95934-332f-d621-eba1-27fc3c67f49c/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/100x100bb.jpg",
          "size": "100x100"
        }
      ],
      "minimum_os_version": "15.0",
      "position": 1,
      "price": {
        "type": "Free"
      },
      "rating": [
        {
          "count": 37178,
          "rating": 4.68,
          "type": "All Times"
        },
        {
          "count": 37178,
          "rating": 4.68,
          "type": "Current Version"
        }
      ],
      "release_date": "2025-02-27 08:00:00 UTC",
      "release_note": "Fixed minor bugs.",
      "screenshots": {
        "general": [
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/06/e6/ba/06e6bae9-fe35-a1d4-a6ee-57e0e3b52e34/GCGC_Screenshot_1_iPhone6.9_ENG.png/320x480bb.jpg",
            "size": "320x480"
          },
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/02/d9/a2/02d9a23b-a0c2-1695-13d1-57a9cffab1c3/GCGC_Screenshot_2_iPhone6.9_ENG.png/320x480bb.jpg",
            "size": "320x480"
          }
        ],
        "ipad": [
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/bf/6e/07/bf6e07c0-635b-aba9-4510-cf8d63deb128/GCGC_Screenshot_1_iPad_ENG.png/360x480bb.jpg",
            "size": "360x480"
          },
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/01/6c/74/016c74e0-8513-2813-cbfd-58217b67fec7/GCGC_Screenshot_2_iPad_ENG.png/360x480bb.jpg",
            "size": "360x480"
          }
        ]
      },
      "seller_link": "http://www.tapblaze.com/app/good-coffee-great-coffee/",
      "size_in_bytes": 1528693760,
      "supported_devices": [
        "iPhone5s-iPhone5s",
        "iPadAir-iPadAir"
      ],
      "supported_languages": [
        "AR",
        "EN"
      ],
      "title": "Good Coffee, Great Coffee",
      "version": "1.21.3",
      "vpp_license": true
    },
    {
      "age_rating": "12+",
      "bundle_id": "com.starbucks.mystarbucks",
      "description": "Ordering ahead is just a download away. Get the Starbucks® app for an easier way to enjoy your favorites and discover Rewards in every sip as a member. \n\nORDER SEAMLESSLY \n• Order in the app when you’re on your way\n• Customize and create your perfect drink\n• Save your favorite stores\n• View past orders & save custom drinks \n• Save payment methods and scan to pay in stores\n• Tip your barista for your delicious drink\n\nJOIN STARBUCKS® REWARDS\n• Earn Stars to use on free food & drinks\n• Start at Green status & level up to Gold or Reserve for exclusive benefits\n• Enjoy a free drink on your birthday ?",
      "developer": {
        "id": 331177718,
        "link": "https://apps.apple.com/us/developer/starbucks-coffee-company/id331177718?uo=4",
        "name": "Starbucks Coffee Company"
      },
      "game_center_enabled": false,
      "genres": [
        {
          "id": 6023,
          "name": "Food & Drink",
          "primary": true
        },
        {
          "id": 6012,
          "name": "Lifestyle",
          "primary": false
        }
      ],
      "id": 331177714,
      "latest_version_release_date": "2026-08-31 16:54:48 UTC",
      "link": "https://apps.apple.com/us/app/starbucks/id331177714?uo=4",
      "logos": [
        {
          "link": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/0c/43/07/0c430762-49fe-b2ff-30b5-a5ee5fe01469/AppIcon-0-0-1x_U007ephone-0-1-0-P3-85-220.png/60x60bb.jpg",
          "size": "60x60"
        },
        {
          "link": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/0c/43/07/0c430762-49fe-b2ff-30b5-a5ee5fe01469/AppIcon-0-0-1x_U007ephone-0-1-0-P3-85-220.png/100x100bb.jpg",
          "size": "100x100"
        }
      ],
      "minimum_os_version": "17.5",
      "position": 2,
      "price": {
        "type": "Free"
      },
      "rating": [
        {
          "count": 8247222,
          "rating": 4.89,
          "type": "All Times"
        },
        {
          "count": 8247222,
          "rating": 4.89,
          "type": "Current Version"
        }
      ],
      "release_date": "2009-09-23 05:33:59 UTC",
      "release_note": "We made some changes to make things run smoothly.",
      "screenshots": {
        "general": [
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/b2/84/9a/b2849a34-8308-31a2-4d1f-9df7546aaaad/_Card1.jpg/320x480bb.jpg",
            "size": "320x480"
          },
          {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/99/d1/68/99d16802-b98d-9aa4-529c-9477a4ee2ca0/_Card2.jpg/320x480bb.jpg",
            "size": "320x480"
          }
        ]
      },
      "seller_link": "http://www.starbucks.com/coffeehouse/mobile-apps/mystarbucks",
      "size_in_bytes": 228815872,
      "supported_devices": [
        "iPhone5s-iPhone5s",
        "iPadAir-iPadAir"
      ],
      "supported_languages": [
        "EN",
        "FR"
      ],
      "title": "Starbucks",
      "version": "6.130",
      "vpp_license": true
    }
  ],
  "search_information": {
    "results_count": 9
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More Apple App Store APIs