Shop.app

Analyze Shop.app query results

Returns a market snapshot derived from Shop.app search results, including price ranges, currencies, sale counts, discounts, and top shops. Limit defaults to 20 and accepts values up to 50.

get/shop-app/analysis

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/shop-app/analysis
  • Auth: API key in header x-api-key

Query parameters

querystring required

Search query

limitinteger

Maximum products to analyze, defaults to 20 and supports up to 50

in_stockboolean

Request in-stock products

on_saleboolean

Request sale products

deep_searchboolean

Accepted for compatibility; Shop.app no longer offers a separate deep search mode, so results are unchanged

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "currencies": [
      "USD",
      "GBP"
    ],
    "discounts": {
      "average_percent": 24.6,
      "max_percent": 60,
      "min_percent": 10
    },
    "groups_count": 5,
    "prices_by_currency": [
      {
        "average": 72.42,
        "count": 12,
        "currency": "USD",
        "max": 149.99,
        "min": 35.9
      }
    ],
    "products_count": 20,
    "query": "sneakers",
    "sale_count": 6,
    "sampled_product_ids": [
      "8075903107261",
      "7093164834901"
    ],
    "shops_count": 8,
    "top_shops": [
      {
        "count": 4,
        "shop_id": "3961166",
        "shop_name": "Start Fitness"
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.