---
title: "Search the App Store"
method: GET
path: "/appstore/search"
tags: ["AppStore"]
---

# Search the App Store

`GET /appstore/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/appstore/search`
- Auth: API key in header `x-api-key`

Returns App Store search results for a term. Set `ids_only=true` to return only app IDs. `platform` enum: `phone`, `pad`, `mac`.

## Query parameters

- `term` string, required
- `num` integer
- `page` integer
- `country` string
- `lang` string
- `ids_only` boolean
- `platform` 'phone' | 'pad' | 'mac'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AppstoreSearchResultsResponseDoc
  - `code` integer
  - `data` unknown[]
    - unknown
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[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)