API

Base URL https://appreviews.vibeserved.com. Every response is JSON. Times are ISO 8601 in UTC. Two stores, three endpoints, one schema.

# 1. sign up, copy the key from the dashboard
export KEY=ar_...

# 2. look up an app
curl https://appreviews.vibeserved.com/v1/apps/apple/310633997 \
    -H "Authorization: Bearer $KEY"

# 3. page through its reviews
curl "https://appreviews.vibeserved.com/v1/apps/google/com.whatsapp/reviews?sort=recent" \
    -H "Authorization: Bearer $KEY"

Authentication

Send your key in either header. Keys start with ar_, are created on the dashboard, and are shown exactly once.

Authorization: Bearer ar_...
X-Api-Key: ar_...

A missing, unknown or revoked key is a 401. Keys are stored as SHA-256 hashes; if you lose one, create another and revoke the old one.

Credits and limits

• One successful request costs one credit: one app lookup, or one page of up to 50 reviews.
• Errors cost nothing. 4xx, 429 and 503 responses never charge.
• Upstream responses are cached for 10 minutes. A cache hit is still one request and still one credit.
• Every metered 200 carries X-Credits-Remaining. /v1/me is free.
• 60 requests per minute per key. Over that you get 429 with Retry-After in seconds.
• At zero credits you get 402 until you buy a pack. Signup grants 300.

App metadata for one storefront.

$ curl "https://appreviews.vibeserved.com/v1/apps/apple/310633997?country=us" \
    -H "Authorization: Bearer $KEY"

{
  "store": "apple",
  "app_id": "310633997",
  "country": "us",
  "title": "WhatsApp Messenger",
  "developer": "WhatsApp Inc.",
  "rating": 4.68,
  "rating_count": 18523223,
  "version": "26.34.72",
  "released_at": "2009-05-04T02:43:49Z",
  "updated_at": "2026-08-31T13:21:38Z",
  "genre": "Social Networking",
  "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/cb/b5/1f/cbb51f14-c56c-f35d-421b-c89f5592a923/AppIcon-0-0-1x_U007epad-0-0-0-1-0-0-sRGB-0-85-220.png/512x512bb.jpg",
  "description": "...",
  "price": 0.0,
  "currency": "USD",
  "url": "https://apps.apple.com/us/app/whatsapp-messenger/id310633997?uo=4",
  "bundle_id": "net.whatsapp.WhatsApp",
  "min_os_version": "15.1",
  "content_rating": "12+",
  "release_notes": "...",
  "installs": null
}

Fields a store does not publish are null: bundle_id, min_os_version on Play; installs on the App Store. Play's version is null when it "varies with device".

Up to 50 reviews per page, newest first by default.

$ curl "https://appreviews.vibeserved.com/v1/apps/google/com.whatsapp/reviews?sort=recent" \
    -H "Authorization: Bearer $KEY"

{
  "store": "google",
  "app_id": "com.whatsapp",
  "country": "us",
  "sort": "recent",
  "reviews": [
    {
      "id": "b927c27d-71e8-4636-b7ab-7cef2c786436",
      "author": "Amma Gana",
      "rating": 5,
      "title": null,
      "body": "Whatsapp",
      "version": "2.26.32.83",
      "created_at": "2026-09-02T16:55:53Z",
      "helpful_count": 0,
      "developer_reply": {
        "body": "Thanks for the feedback.",
        "replied_at": "2026-09-03T10:29:55Z"
      },
      "url": null
    }
  ],
  "next_cursor": "v1.WyJnb29nbGUiLCJjb20ud2hhdHNhcHAiLCJ1cyIsInJlY2VudCIsIkNzY0IiXQ.k3Qx7f2Zt0JgXQ"
}

App Store reviews have title and url and no developer_reply. Play reviews have developer_reply and no title or url. Everything else is identical across stores.

Balance and limits for the calling key. Never costs a credit, so it is safe to poll.

$ curl https://appreviews.vibeserved.com/v1/me -H "Authorization: Bearer $KEY"
{
  "credits": 4812,
  "key_prefix": "ar_7Hk2mP9q",
  "rate_limit": {
    "per_minute": 60
  }
}

Cursors

• next_cursor is opaque and signed. Pass it back unchanged with the same store, app_id, country and sort; anything else is 400.
• next_cursor: null means the end. The App Store publishes at most 500 reviews per storefront (10 pages).
• Cursors are not stable forever; upstream ordering shifts as new reviews land. Walk a listing in one sitting.

Errors

Every error is { "error": { "code": "...", "message": "..." } } and none of them cost a credit.