Endpoint Playground

Try the Search Shop.app products API

Searches Shop.app product results. Limit defaults to 20 and accepts values up to 50.

What a live request returned

14 Oct 2026: 20 products; 10 fields had a value in every checked item and 3 varied between items.

Observed request: GET /shop-app/search?limit=20&query=sneakers
Fields with a value in every checked item: id, variant_id, title, url, shop_id, shop_name, price, currency

Sample value profiles: price: 75 to 257, median 135; title: “Crossover™ Victory Trainer” and 19 other values; url: wolfandshepherd.com and 10 other hosts.

Request: GET /shop-app/search
Cost: 5 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 86.7%, median 1.72 s
Monitored request: GET /shop-app/search?limit=5&query=sneakers

Search Shop.app products API documentation Shop.app platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/shop-app/search?query=sneakers&limit=10&in_stock=true' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	Yes	sneakers	Search query
limit	integer	No	10	Maximum products, defaults to 20 and supports up to 50
in_stock	boolean	No	true	Request in-stock products
on_sale	boolean	No		Request sale products
deep_search	boolean	No		Accepted for compatibility; Shop.app no longer offers a separate deep search mode, so results are unchanged

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "sneakers",
    "limit": 5,
    "products": [
      {
        "id": "8075903107261",
        "variant_id": "46242960965821",
        "title": "Black/Black/Gum BILLY Sport Inclusion DZ1",
        "url": "https://billyfootwear.com/products/black-black-gum-billy-sport-inclusion-dz1-zipper-shoes?utm_source=shop_app",
        "shop_id": "62696",
        "shop_name": "BILLY Footwear",
        "price": 100,
        "currency": "USD",
        "position": 1
      }
    ]
  }
}

More Shop.app endpoints

Analyze Shop.app query results List Shop.app categories Get Shop.app product List Shop.app related products List Shop.app product reviews Get the Shop.app shop for a product Get a Shop.app product variant by selected options List Shop.app product variants Get Shop.app shop List Shop.app collection products List Shop.app shop locations List Shop.app shop products All 16 Shop.app endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey5 credits/requestshopapp.searchResponseDocShop.app

GET /shop-app/search

Search Shop.app products

Searches Shop.app product results. Limit defaults to 20 and accepts values up to 50.

Response behavior

- Products are deduplicated by product id and variant id. - Results come from Shop.app's public search feed in its ranking order; a `limit` above one feed page is filled by following the feed's cursor. - `groups` and each product's `group_title` are returned only when Shop.app supplies expanded product groups. Its current search feed does not, so they are normally absent. - Blocked pages, malformed responses, and product cards that cannot be parsed return an upstream error instead of `200 []`.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

query

requiredstring

Search query

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "sneakers",
    "limit": 5,
    "products": [
      {
        "id": "8075903107261",
        "variant_id": "46242960965821",
        "title": "Black/Black/Gum BILLY Sport Inclusion DZ1",
        "url": "https://billyfootwear.com/products/black-black-gum-billy-sport-inclusion-dz1-zipper-shoes?utm_source=shop_app",
        "shop_id": "62696",
        "shop_name": "BILLY Footwear",
        "price": 100,
        "currency": "USD",
        "position": 1
      }
    ]
  }
}

Endpoint Playground

Try the Search Shop.app products API

Searches Shop.app product results. Limit defaults to 20 and accepts values up to 50.

What a live request returned

14 Oct 2026: 20 products; 10 fields had a value in every checked item and 3 varied between items.

Observed request: GET /shop-app/search?limit=20&query=sneakers
Fields with a value in every checked item: id, variant_id, title, url, shop_id, shop_name, price, currency

Sample value profiles: price: 75 to 257, median 135; title: “Crossover™ Victory Trainer” and 19 other values; url: wolfandshepherd.com and 10 other hosts.

Request: GET /shop-app/search
Cost: 5 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 86.7%, median 1.72 s
Monitored request: GET /shop-app/search?limit=5&query=sneakers

Search Shop.app products API documentation Shop.app platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/shop-app/search?query=sneakers&limit=10&in_stock=true' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	Yes	sneakers	Search query
limit	integer	No	10	Maximum products, defaults to 20 and supports up to 50
in_stock	boolean	No	true	Request in-stock products
on_sale	boolean	No		Request sale products
deep_search	boolean	No		Accepted for compatibility; Shop.app no longer offers a separate deep search mode, so results are unchanged

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "sneakers",
    "limit": 5,
    "products": [
      {
        "id": "8075903107261",
        "variant_id": "46242960965821",
        "title": "Black/Black/Gum BILLY Sport Inclusion DZ1",
        "url": "https://billyfootwear.com/products/black-black-gum-billy-sport-inclusion-dz1-zipper-shoes?utm_source=shop_app",
        "shop_id": "62696",
        "shop_name": "BILLY Footwear",
        "price": 100,
        "currency": "USD",
        "position": 1
      }
    ]
  }
}

More Shop.app endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey5 credits/requestshopapp.searchResponseDocShop.app

GET /shop-app/search

Search Shop.app products

Searches Shop.app product results. Limit defaults to 20 and accepts values up to 50.

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

query

requiredstring

Search query

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "sneakers",
    "limit": 5,
    "products": [
      {
        "id": "8075903107261",
        "variant_id": "46242960965821",
        "title": "Black/Black/Gum BILLY Sport Inclusion DZ1",
        "url": "https://billyfootwear.com/products/black-black-gum-billy-sport-inclusion-dz1-zipper-shoes?utm_source=shop_app",
        "shop_id": "62696",
        "shop_name": "BILLY Footwear",
        "price": 100,
        "currency": "USD",
        "position": 1
      }
    ]
  }
}