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.

Skip to content
← All documentation

// Shopify documentation

Shopify Products API

Page through published product catalogs with variants, prices, and availability.

GET / POST https://api.litescrape.com/api/shopify/products

For background execution, use POST /api/shopify/products/async. Learn how to submit and poll async requests →

// from request to code

Integrate Shopify Products

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

APIShopify Products
More options 2
Request parameters

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 --request POST 'https://api.litescrape.com/api/shopify/products' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "store": "allbirds",
  "limit": 2
}'

Read all parameters →

JSON POST request example

POST to https://api.litescrape.com/api/shopify/products with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "store": "allbirds",
  "limit": 2
}

// request reference

Shopify Products parameters

Send query parameters with GET /api/shopify/products. 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 parameters

store
StoreRequired

Shopify store subdomain, or allbirds or colourpop for their public storefronts. The store must publish its product catalog.

Type string · GET query or POST JSON

  • Pattern: ^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$
page
PageOptional

Product page, starting at one.

Type integer · GET query or POST JSON · Default 1

  • Minimum: 1
  • Maximum: 1000
limit
LimitOptional

Products per page, up to 250.

Type integer · GET query or POST JSON · Default 20

  • Minimum: 1
  • Maximum: 250

// 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 store, page, next_page, products, search_parameters, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Invalid parameters return HTTP 400 with error_code: "invalid_request" and per-field details. Unavailable resources return HTTP 404 with error_code: "not_found". Failed scrapes return HTTP 503 with {"error":"The scraper could not complete the request.","error_code":"service_unavailable"}. Failed requests are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

200 · application/json
{
  "store": "allbirds",
  "page": 1,
  "next_page": 2,
  "products": [
    {
      "id": 7340901859408,
      "title": "Women's Allbirds Flip Flop - Dusty Pink",
      "handle": "womens-allbirds-flip-flop-dusty-pink",
      "url": "https://www.allbirds.com/products/womens-allbirds-flip-flop-dusty-pink",
      "description": "Sun on your feet. Comfort underneath. Light, easy, and made for warm weather, these flip flops bring everyday comfort to sunny days, beach walks, and everything in between. Just slip them on and go.",
      "vendor": "Allbirds",
      "product_type": "Shoes",
      "images": [
        "https://cdn.shopify.com/s/files/1/1104/4168/files/A12513_26Q2_Allbirds-Flip-Flop-Dusty-Pink_PDP_LEFT.png?v=1774646345",
        "https://cdn.shopify.com/s/files/1/1104/4168/files/A12513_26Q2_Allbirds-Flip-Flop-Dusty-Pink_PDP_BACK.png?v=1774646345",
        "https://cdn.shopify.com/s/files/1/1104/4168/files/A12513_26Q2_Allbirds-Flip-Flop-Dusty-Pink_PDP_TD.png?v=1774646346",
        "https://cdn.shopify.com/s/files/1/1104/4168/files/A12513_26Q2_Allbirds-Flip-Flop-Dusty-Pink_PDP_SOLE.png?v=1774646346",
        "https://cdn.shopify.com/s/files/1/1104/4168/files/A12513_26Q2_Allbirds-Flip-Flop-Dusty-Pink_PDP_PAIR_3Q.png?v=1774646345"
      ],
      "variants": [
        {
          "id": 42146889039952,
          "title": "5",
          "sku": "A12513W050",
          "price": "25.00",
          "compare_at_price": "50.00",
          "available": false
        },
        {
          "id": 42146889072720,
          "title": "6",
          "sku": "A12513W060",
          "price": "25.00",
          "compare_at_price": "50.00",
          "available": false
        },
        {
          "id": 42146889105488,
          "title": "7",
          "sku": "A12513W070",
          "price": "25.00",
          "compare_at_price": "50.00",
          "available": false
        },
        {
          "id": 42146889138256,
          "title": "8",
          "sku": "A12513W080",
          "price": "25.00",
          "compare_at_price": "50.00",
          "available": false
        },
        {
          "id": 42146889171024,
          "title": "9",
          "sku": "A12513W090",
          "price": "25.00",
          "compare_at_price": "50.00",
          "available": false
        },
        {
          "id": 42146889203792,
          "title": "10",
          "sku": "A12513W100",
          "price": "25.00",
          "compare_at_price": "50.00",
          "available": true
        },
        {
          "id": 42146889236560,
          "title": "11",
          "sku": "A12513W110",
          "price": "25.00",
          "compare_at_price": "50.00",
          "available": false
        }
      ]
    },
    {
      "id": 7258385809488,
      "title": "Men's Canvas Runner NZ - Deep Navy Stripes (Blizzard Sole)",
      "handle": "mens-canvas-runner-nz",
      "url": "https://www.allbirds.com/products/mens-canvas-runner-nz",
      "description": "",
      "vendor": "Allbirds",
      "product_type": "Shoes",
      "images": [
        "https://cdn.shopify.com/s/files/1/1104/4168/files/A12500_26Q1_Runner-NZ-Canvas-Stripes-Deep-Navy-Blizzard-Sole_PDP_LEFT.png?v=1774550585",
        "https://cdn.shopify.com/s/files/1/1104/4168/files/A12500_26Q1_Runner-NZ-Canvas-Stripes-Deep-Navy-Blizzard-Sole_PDP_BACK.png?v=1774550584",
        "https://cdn.shopify.com/s/files/1/1104/4168/files/A12500_26Q1_Runner-NZ-Canvas-Stripes-Deep-Navy-Blizzard-Sole_PDP_TD.png?v=1774550586",
        "https://cdn.shopify.com/s/files/1/1104/4168/files/A12500_26Q1_Runner-NZ-Canvas-Stripes-Deep-Navy-Blizzard-Sole_PDP_SOLE.png?v=1774550584",
        "https://cdn.shopify.com/s/files/1/1104/4168/files/A12500_26Q1_Runner-NZ-Canvas-Stripes-Deep-Navy-Blizzard-Sole_PDP_PAIR_3Q.png?v=1774550585"
      ],
      "variants": [
        {
          "id": 41884546990160,
          "title": "8",
          "sku": "A12498M080",
          "price": "100.00",
          "compare_at_price": null,
          "available": false
        },
        {
          "id": 41884547022928,
          "title": "8.5",
          "sku": "A12498M085",
          "price": "100.00",
          "compare_at_price": null,
          "available": true
        },
        {
          "id": 41884547055696,
          "title": "9",
          "sku": "A12498M090",
          "price": "100.00",
          "compare_at_price": null,
          "available": false
        },
        {
          "id": 41884547088464,
          "title": "9.5",
          "sku": "A12498M095",
          "price": "100.00",
          "compare_at_price": null,
          "available": false
        },
        {
          "id": 41884547121232,
          "title": "10",
          "sku": "A12498M100",
          "price": "100.00",
          "compare_at_price": null,
          "available": true
        },
        {
          "id": 41884547154000,
          "title": "10.5",
          "sku": "A12498M105",
          "price": "100.00",
          "compare_at_price": null,
          "available": true
        },
        {
          "id": 41884547186768,
          "title": "11",
          "sku": "A12498M110",
          "price": "100.00",
          "compare_at_price": null,
          "available": true
        },
        {
          "id": 41884547219536,
          "title": "11.5",
          "sku": "A12498M115",
          "price": "100.00",
          "compare_at_price": null,
          "available": false
        },
        {
          "id": 41884547252304,
          "title": "12",
          "sku": "A12498M120",
          "price": "100.00",
          "compare_at_price": null,
          "available": false
        },
        {
          "id": 41884547285072,
          "title": "12.5",
          "sku": "A12498M125",
          "price": "100.00",
          "compare_at_price": null,
          "available": false
        },
        {
          "id": 41884547317840,
          "title": "13",
          "sku": "A12498M130",
          "price": "100.00",
          "compare_at_price": null,
          "available": false
        },
        {
          "id": 41884547350608,
          "title": "13.5",
          "sku": "A12498M135",
          "price": "100.00",
          "compare_at_price": null,
          "available": false
        },
        {
          "id": 41884547383376,
          "title": "14",
          "sku": "A12498M140",
          "price": "100.00",
          "compare_at_price": null,
          "available": true
        }
      ]
    }
  ],
  "search_parameters": {
    "store": "allbirds",
    "page": 1,
    "limit": 2
  },
  "submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}