# Overview ASOMobile API

## Overview
The ASOMobile API is a REST API for App Store and Google Play data. It provides programmatic access to keyword rankings, search traffic scores, top charts, app profiles, competitors, reviews, Apple Search Ads insights, and organic download estimates — the same data that powers the ASOMobile ASO platform. Use it to build ASO tools, dashboards, and automated app analytics workflows.

## Authentication

To access any endpoint, you must include a valid API token in the `Authorization` header:
+ Example

        `Authorization: Bearer YOUR_API_TOKEN`
        
You can obtain your personal API token in your account [API Dashboard](https://app.asomobile.net/api-dashboard).


## Request Flow

Each endpoint follows a two-step flow:

1. **Initialize request** → returns `ticket_id`
2. **Poll result** using `GET /endpoint/result?ticket_id=...`

+ Example

        ```
        GET /endpoint
        → { "code": "SUCCESS", "data": { "ticket_id": "12345" }}`

        GET /endpoint/result?ticket_id=12345
        → { "code": "SUCCESS", "data": {...} }
        ```



## Response Format

All API responses follow a standard structure:

+ Response Format (application/json)

      ``` 
      {
            "code": "SUCCESS",
            "data": { ... },
            "message": "Optional description"
      }
        ```

+ Fields

    + `code` (number) — response status code
    + `data` (object or array) — actual payload
    + `message` (string) — response description

## MCP
Allow AI tools to access full API docs site for AI-assisted coding.

You can also use "One-click setup" on any request page.

```
{
  "mcpServers": {
    "ASOMobile": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--site-id=756567"
      ]
    }
  }
}
```