# AppGallery Search API Documentation

<p>Searches the public Huawei AppGallery and returns app ids and hints. Search relevance is low, so read ratings and full data from the detail endpoint. The developer hint is empty on every search row. An empty result is not charged. A page that repeats page 1 returns 422. A non-empty request costs 1 credit. A failed request is not charged.</p>

- **Documentation:** [https://scrappa.co/docs/appgallery-api/appgallery_search](https://scrappa.co/docs/appgallery-api/appgallery_search)
- **API group:** AppGallery API
- **Endpoint:** `GET https://scrappa.co/api/appgallery/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | Search terms. |
| `page` | integer | No | Page number, default 1. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error or Repeated Page | The parameters failed validation or the page repeats page 1 ids. |
| 503 | Upstream Unavailable | AppGallery could not be reached. Not charged. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
