---
title: "Analyze Shop.app query results"
method: GET
path: "/shop-app/analysis"
tags: ["Shop.app"]
---

# Analyze Shop.app query results

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

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.

## Query parameters

- `query` string, required
- `limit` integer
- `in_stock` boolean
- `on_sale` boolean
- `deep_search` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ShopappAnalysisResponseDoc
  - `code` integer
  - `data` ShopappAnalysisResponse
    - `currencies` string[]: Currency codes found among the sampled products.
    - `discounts` ShopappDiscountSummary
      - `average_percent` number: Average discount across on-sale products, as a percentage of the original price.
      - `max_percent` number: Largest discount among on-sale products, as a percentage of the original price.
      - `min_percent` number: Smallest discount among on-sale products, as a percentage of the original price.
    - `groups_count` integer: Number of product groups Shop.app returned with the results.
    - `prices_by_currency` ShopappCurrencyPriceSummary[]: Price summary for each currency found among the sampled products.
      - `average` number: Average price in this currency, rounded to two decimals.
      - `count` integer: Number of sampled products priced in this currency.
      - `currency` string: Currency code of the prices.
      - `max` number: Highest price in this currency.
      - `min` number: Lowest price in this currency.
    - `products_count` integer: Number of products sampled.
    - `query` string: Search query that was analyzed.
    - `sale_count` integer: Number of sampled products that are on sale.
    - `sampled_product_ids` string[]: Product IDs of the first sampled products, up to 10.
    - `shops_count` integer: Number of distinct shops among the sampled products.
    - `top_shops` ShopappShopSummary[]: Up to five shops with the most sampled products.
      - `count` integer: Number of sampled products from this shop.
      - `shop_id` string: Shop.app ID of the shop.
      - `shop_name` string: Name of the shop.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)