Sniff is a specialized API service designed to retrieve Google Play Store app details across different release channels (Stable, Beta, Alpha). It provides a clean interface to access app metadata including version information, changelog, download sizes, and other details for Android applications.

Features

• Multi-Channel Support: Access app details from Stable, Beta, and Alpha channels (where available)
• Intelligent Track Detection: Automatically identifies which channels are available for specific apps
• Multi-Arch Downloads: Download info merges splits across devices (arm64-v8a, armeabi-v7a, plus density/locale) so one call lists every APK split the app ships
• Unified API: Simple REST API endpoints for accessing app information

API Endpoints

Interactive API reference is served at /docs.

Get App Details (All Available Channels)

GET /v1/details/:package_name

Returns details for all available channels for the specified package.

Response Headers:

• X-Available-Channels: Comma-separated list of available channels for the app

Successful response:

{
    "success": true,
    "data": {
        // channel name -> details (only available channels are present)
        "stable": { "item": {/* see single-channel shape below */} },
        "beta": { "item": {/* ... */} }
        // "alpha" if available
    },
    "error": null
}

Get App Details (Specific Channel)

GET /v1/details/:package_name/:channel

Returns details for a specific channel (stable, beta, or alpha) if available.

Possible channels:

• stable - Production release (always available)
• beta - Beta program release (only available for certain apps)
• alpha - Alpha program release (only available for certain apps)

Response Format:

Successful response (GET /v1/details/com.discord/stable, trimmed):

{
    "success": true,
    "data": {
        "item": {
            "id": "com.discord",
            "sub_id": "com.discord",
            "type": 1,
            "category_id": 3,
            "title": "Discord - Talk, Play, Hang Out",
            "creator": "Discord Inc.",
            "description_html": "Discord is designed for gaming...",
            "offer": [
                {
                    "micros": 0,
                    "currency_code": "EUR",
                    "formatted_amount": "",
                    "checkout_flow_required": false,
                    "offer_type": 1
                }
            ],
            "details": {
                "app_details": {
                    "developer_name": "Discord Inc.",
                    "version_code": 345009,
                    "version_string": "345.9 - Stable",
                    "info_download_size": 159659592,
                    "developer_email": "support@discord.com",
                    "developer_website": "https://dis.gd/contact",
                    "info_download": "500,000,000+ downloads",
                    "package_name": "com.discord",
                    "recent_changes_html": "We've been hard at work...",
                    "info_updated_on": "Sep 11, 2026",
                    "target_sdk_version": 36
                }
            },
            "app_info": {
                "section": [
                    {
                        "label": "In-app purchases",
                        "container": {
                            "description": "€0.84 - €274.99 if billed through Play"
                        }
                    },
                    {
                        "label": "Offered by",
                        "container": { "description": "Google Commerce Ltd" }
                    },
                    {
                        "label": "Released on",
                        "container": { "description": "May 13, 2015" }
                    }
                ]
            },
            "mature": false,
            "promotional_description": "Group Chat That's Fun & Games",
            "available_for_preregistration": false,
            "force_shareability": false
        },
        "footer_html": "All prices include VAT.",
        "enable_reviews": false
    },
    "error": null
}

Error responses:

{
    "success": false,
    "data": null,
    "error": "Error message describing the issue"
}

Get Download Info for a Specific App Version

GET /v1/download/:package_name/:channel/:version_code

Retrieves download URLs for a specific version of an app from a particular channel. Splits are merged across download devices (px_9a/arm64-v8a, sm_a13_5g/armeabi-v7a, google_kiwi_x86_64/x86+x86_64), so the response lists every architecture the app actually ships. ABIs the app has no build for (e.g. x86 for arm-only apps) are skipped — a partial merge still returns 200.

Parameters:

• package_name: The package identifier of the app (e.g., com.discord)
• channel: Release channel (stable, beta, or alpha)
• version_code: The specific Android version code to download (integer, see details.app_details.version_code)

Response Format:

Successful response (GET /v1/download/com.discord/stable/345009, URLs trimmed):

{
    "success": true,
    "data": {
        "main_apk_url": "https://play.googleapis.com/download/by-token/download?token=...",
        "splits": [
            {
                "name": "config.arm64_v8a",
                "download_url": "https://play.googleapis.com/download/by-token/download?token=..."
            },
            {
                "name": "config.en",
                "download_url": "https://play.googleapis.com/download/by-token/download?token=..."
            },
            {
                "name": "config.it",
                "download_url": "https://play.googleapis.com/download/by-token/download?token=..."
            },
            {
                "name": "config.xxhdpi",
                "download_url": "https://play.googleapis.com/download/by-token/download?token=..."
            },
            {
                "name": "config.armeabi_v7a",
                "download_url": "https://play.googleapis.com/download/by-token/download?token=..."
            },
            {
                "name": "config.xhdpi",
                "download_url": "https://play.googleapis.com/download/by-token/download?token=..."
            }
        ],
        "additional_files": [],
        "dex_metadata_url": "https://play.googleapis.com/download/by-token/download?token=..."
    },
    "error": null
}

Error response:

{
    "success": false,
    "data": null,
    "error": "App not found or version unavailable"
}

Build From Source

Prerequisites:

• Rust stable with the wasm32-unknown-unknown target (rustup target add wasm32-unknown-unknown)
• Bun (used to run Wrangler)
• A Cloudflare account for deploy only (not needed for local dev)

git clone https://github.com/madkarmaa/sniff
cd sniff
rustup target add wasm32-unknown-unknown

1. Mint Google Play tokens

Each channel needs a Google account email plus an AAS token. To mint an AAS token from a one-time OAuth token (see gpapi/src/lib.rs docs for how to grab the oauth2_4/ cookie), use the helper:

cargo run -p oauth2aas -- <email> <oauth_token>

It prints the AAS token. Repeat for every account you plan to use.

2. Local dev

Create .dev.vars (gitignored, picked up automatically by wrangler dev):

DEVICE_NAME="sm_a13_5g"
STABLE_EMAIL="..."
STABLE_AAS_TOKEN="..."
BETA_EMAIL="..."
BETA_AAS_TOKEN="..."
ALPHA_EMAIL="..."
ALPHA_AAS_TOKEN="..."

STABLE_* is required; beta/alpha pairs are optional and only needed for those channels. Then:

bun install
bun run dev
curl -fsSL -A "Mozilla/5.0" http://localhost:8787/v1/details/com.discord/stable

3. Checks

cargo check --all
cargo fmt --all -- --check
cargo clippy --all -- -D warnings

Environment Variables

The following environment variables are required:

• DEVICE_NAME: Device identifier for Google Play API (default sm_a13_5g in wrangler.toml)
• STABLE_EMAIL: Email for stable track access
• STABLE_AAS_TOKEN: Authentication token for stable track
• BETA_EMAIL: Email enrolled in beta programs
• BETA_AAS_TOKEN: Authentication token for beta access
• ALPHA_EMAIL: Email enrolled in alpha programs
• ALPHA_AAS_TOKEN: Authentication token for alpha access