Google Play search
POST https://tools.yukai.uk/api/v1/appstore/play/search
Search Google Play apps. Apps that Google Play shows for search words in a language and country (first page, up to 30): package name, title, developer, rating, installs, price, summary and icon.
Cost
Credits: 5 per app ($0.0005 per app). 100 credits are reserved before the call; the call is then settled on the real number of items returned. Failed calls are free. Source price: app-store-top-charts/chart-entry.
Input
Send a JSON body (POST) or the same fields as a query string (GET).
Required: q.
| Field | Type | Default | Description |
|---|---|---|---|
q required | string | Search words. Aliases: term, query. | |
lang | string | "en" | Language of the store text and of the reviews (en, ja, pt-BR, zh-TW...). Alias: hl. |
country | string | "us" | Two-letter Google Play country (prices, currency, availability). Alias: gl. |
price | string | "all" | Only free or only paid apps. |
limit | integer | 30 | Maximum apps returned. |
Examples
Replace tt_live_XXXX with your key from the pricing page.
curl
curl -i -X POST "https://tools.yukai.uk/api/v1/appstore/play/search" \
-H "Authorization: Bearer tt_live_XXXX" \
-H "Content-Type: application/json" \
-d '{"q":"habit tracker"}'JavaScript (fetch)
const res = await fetch("https://tools.yukai.uk/api/v1/appstore/play/search", {
method: "POST",
headers: { "Authorization": "Bearer tt_live_XXXX", "Content-Type": "application/json" },
body: JSON.stringify({"q":"habit tracker"}),
});
console.log(res.status, res.headers.get("x-credits-charged"), res.headers.get("x-credits-balance"));
console.log(await res.json());Python (requests)
import requests
r = requests.post(
"https://tools.yukai.uk/api/v1/appstore/play/search",
headers={"Authorization": "Bearer tt_live_XXXX"},
json={"q": "habit tracker"},
timeout=120,
)
print(r.status_code, r.headers.get("x-credits-charged"), r.headers.get("x-credits-balance"))
print(r.json())Response
JSON with "success": true and the result fields; on failure {"success": false, "error": {"code", "message", "retryable"}} and no credits are used. Every answer carries x-credits-charged (credits used) and x-credits-balance (balance after the call); check the balance any time with GET https://tools.yukai.uk/v1/billing/balance.
Full field list and response schema: OpenAPI spec app-store (its servers entry is the marketplace gateway; call https://tools.yukai.uk with your key).