PalmDevs/sniff

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
Unified API: Simple REST API endpoints for accessing app information

API Endpoints

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

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 responses follow this structure:

{
  "success": true,
  "data": {
    // For multi-channel: track name -> details
    "stable": {
      /* app details */
    },
    "beta": {
      /* app details */
    },
    // Alpha if available
  },
  "error": null,
}

Error responses:

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

Get Download URL for a Specific App Version

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

Retrieves the download URL for a specific version of an app from a particular channel.

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)

Response Format:

Successful response:

{
  "success": true,
  "data": [
    "https://play.googleapis.com/download/by-token/download?token=tkn",
    [
      [
        "config.xxhdpi",
        "https://play.googleapis.com/download/by-token/download?token=tkn"
      ],
      [
        "config.sk",
        "https://play.googleapis.com/download/by-token/download?token=tkn"
      ],
      [
        "config.cs",
        "https://play.googleapis.com/download/by-token/download?token=tkn"
      ],
      [
        "config.en",
        "https://play.googleapis.com/download/by-token/download?token=tkn"
      ],
      [
        "config.arm64_v8a",
        "https://play.googleapis.com/download/by-token/download?token=tkn"
      ]
    ],
    []
  ],
  "error": null
}

Error response:

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

Deployment

Sniff is designed to be deployed as a Cloudflare Worker, providing global distribution and low-latency access to the API.

Environment Variables

The following environment variables are required:

DEVICE_NAME: Device identifier for Google Play API
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

README