Scrape App Store search results
import { Stophy } from "stophy";
const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.appstore.search({ query: "notes", country: "gb", device: "ipad" });
console.log(result.data.results);
from stophy import Stophy
stophy = Stophy() # reads STOPHY_API_KEY
result = stophy.appstore.search(query="notes", country="gb", device="ipad")
print(result["data"]["results"])
curl -X POST https://api.stophy.dev/v1/appstore/search \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{"query":"notes","country":"gb","device":"ipad"}'
stophy appstore search notes --country gb --device ipad
{
"success": true,
"data": {
"results": [
{
"appId": "abc123",
"appUrl": "https://example.com/",
"bundleId": "abc123",
"name": "Example title",
"developerId": "abc123",
"developerName": "example",
"developerUrl": "https://example.com/",
"seller": "example",
"website": "https://example.com/",
"price": 19.99,
"priceCurrency": "example",
"priceText": "example",
"genres": [
"example"
],
"primaryGenreId": "abc123",
"primaryGenre": "example",
"contentRating": "example",
"description": "A short, readable summary of the result.",
"releaseNotes": "example",
"version": "example",
"releasedAt": "2026-09-28T12:00:00.000Z",
"updatedAt": "2026-09-28T12:00:00.000Z",
"minimumOsVersion": "example",
"sizeBytes": 1,
"languages": [
"example"
],
"rating": 4.5,
"ratings": 4.5,
"iconUrl": "https://example.com/",
"screenshotUrls": [
"https://example.com/"
],
"ipadScreenshotUrls": [
"https://example.com/"
]
}
]
},
"creditsUsed": 1,
"requestId": "b2423fd6-b564-4c9a-8f57-aba599110553"
}
Endpoints
| Endpoint | Cost |
|---|---|
| Scrape an App Store app page | 1 credit |
| Scrape App Store search results | From 1 credit |
| Scrape an App Store app’s reviews | 1 credit (no key needed) |
| Scrape App Store top charts | From 1 credit |
| Scrape a Google Play app page | 1 credit |
| Scrape Google Play search results | From 1 credit |
| Scrape a Google Play app’s reviews | 1 credit (no key needed) |
More ways to call it
Scrape a Google Play app’s reviews
import { Stophy } from "stophy";
const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.google.play.reviews({ appId: "com.spotify.music" });
console.log(result.data.results);
from stophy import Stophy
stophy = Stophy() # reads STOPHY_API_KEY
result = stophy.google.play.reviews(app_id="com.spotify.music")
print(result["data"]["results"])
curl -X POST https://api.stophy.dev/v1/google/play/reviews \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{"appId":"com.spotify.music"}'
stophy google play reviews --appId com.spotify.music
Scrape App Store top charts
import { Stophy } from "stophy";
const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.appstore.top({});
console.log(result.data.results);
from stophy import Stophy
stophy = Stophy() # reads STOPHY_API_KEY
result = stophy.appstore.top()
print(result["data"]["results"])
curl -X POST https://api.stophy.dev/v1/appstore/top \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{}'
stophy appstore top
App Store reviews and Google Play reviews work without a key. Pass an App Store app id or a Google Play package name from a search result into that store’s other endpoints. Search and chart endpoints cost 1 credit per 10 apps, and
limit returns fewer. Review endpoints page. See Page through results.