Widgets and public API

What you can show

Everything here comes from reviews written on TrueLaunch. It never includes Google Play or App Store ratings, reviews or download counts, and you must not present it as if it were a store rating.

• Rating badge: a small image with your rating and review count, for a website or README.
• Review widget: a card with your rating and up to 3 reviews. It picks the reviews people found most helpful; you can't choose which ones appear.
• Public API: JSON for apps, reviews and daily launches.

Sign in and open Widgets in your dashboard: pick your app, choose a style and copy the code.

Rating badge

An SVG image. Add ?theme=dark for dark backgrounds.

<a href="https://truelaunch.vascario.com/apps/your-app"><img src="https://truelaunch.vascario.com/api/badges/your-app.svg" alt="Your App on TrueLaunch" height="22" /></a>

Review widget

An <iframe> that runs no scripts and only opens TrueLaunch in a new tab. Options: theme (light or dark) and reviews (0 to 3). Set the height to match the number of reviews: 140px for 0, 252px for 1, 364px for 2, 476px for 3.

<iframe src="https://truelaunch.vascario.com/api/embed/apps/your-app?reviews=3" title="Your App reviews on TrueLaunch" width="100%" height="476" style="border:0;max-width:480px" loading="lazy"></iframe>

Public API

Base URL https://truelaunch.vascario.com/api/v1. Read-only, JSON, no key and no cookies. You can call it from a server or straight from a browser (CORS is open). Use the slug from the app's address: /apps/tiny-quest has the slug tiny-quest. A renamed app still answers to its old slug.

const response = await fetch("https://truelaunch.vascario.com/api/v1/apps/tiny-quest");
const { app } = await response.json();
console.log(`${app.title}: ${app.rating.average} from ${app.rating.count} reviews`);

GET /api/v1/apps/{slug}

A published app with its rating. rating.stars counts the 1, 2, 3, 4 and 5 star reviews. Returns 404 for apps that don't exist or aren't public.

{
  "app": {
    "slug": "tiny-quest",
    "title": "Tiny Quest",
    "tagline": "A pocket-sized puzzle adventure.",
    "type": "GAME",
    "platform": "ANDROID",
    "category": { "slug": "games-puzzle", "name": "Puzzle" },
    "iconUrl": "https://…/icon.webp",
    "url": "https://truelaunch.vascario.com/games/tiny-quest",
    "developer": { "username": "maya-builds", "name": "Maya", "url": "https://truelaunch.vascario.com/developers/maya-builds" },
    "rating": { "average": 4.33, "count": 12, "stars": [0, 1, 1, 3, 7] },
    "upvotes": 48,
    "createdAt": "2026-10-01T09:30:00.000Z"
  }
}

GET /api/v1/apps/{slug}/reviews

Published reviews. Query: sort (helpful, the default, or new), limit (1 to 20, default 10) and cursor (the nextCursor from the previous page).

{
  "reviews": [
    {
      "id": "6c1f…",
      "rating": 5,
      "pros": "The tile sliding feels great.",
      "cons": "Later levels get repetitive.",
      "helpfulCount": 7,
      "developerReply": "Thanks! New levels are coming.",
      "reviewer": { "username": "sam-plays", "name": "Sam" },
      "createdAt": "2026-10-03T18:02:11.000Z"
    }
  ],
  "nextCursor": "6c1f…"
}

GET /api/v1/launches

One day's launches, best first. Query: date (YYYY-MM-DD, UTC; today by default). Days run midnight to midnight UTC, and ranks can change until the day ends (live is true until then). Sponsored spots are never part of launches.

{
  "date": "2026-10-27",
  "live": true,
  "launches": [
    {
      "rank": 1,
      "votes": 31,
      "award": null,
      "headline": "Now with daily puzzles",
      "app": { "slug": "tiny-quest", "title": "Tiny Quest", "tagline": "…", "iconUrl": "https://…", "url": "https://truelaunch.vascario.com/games/tiny-quest" }
    }
  ]
}

Limits, caching and errors

• Up to 120 requests a minute per IP address. Over that you get 429; wait a minute.
• Responses are cached for up to 5 minutes (launches: 1 minute), so new reviews can take that long to appear.
• Errors are JSON: { "statusCode": 404, "error": "Not Found", "message": "…" }.
• Within v1 we only add fields; we never rename or remove them. Breaking changes would come as v2.

Fair use

• Link back to the app's TrueLaunch page (each response includes its url) when you show ratings or reviews.
• Show reviews as written. Don't edit them, and don't show only the good ones while calling them representative.
• Don't imply TrueLaunch endorses your app, and don't use the data to contact or profile reviewers.
• The Terms of service and Developer terms apply.