Full listing for one app
app_details is a $0.20 GET request on the Wuthering AI API. Get the complete store listing for a specific app. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/app_details
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/app_details?platform=…&token=YOUR_TOKEN'
What does app_details return, and when should you call it?
Return the full store record for one app: description, rating, review count, pricing, screenshots, category, and similar apps.
Reads the listing as published. It does not return review text, which is wuthering_app_reviews. On Android the id is a package name, and an invalid id is billed rather than rejected, so verify the id before calling.
Returns: title, description, developer, rating, reviews_count, price, category, similar_apps, images, advisories.
Use to read a competitor's positioning in their own words. Don't use to gather complaints.
What parameters does app_details take?
app_details accepts 5 parameters, of which 2 are required. Array values are comma-separated on the query string.
| Parameter | Type | Required | Description |
|---|---|---|---|
| platform | string | yes | Which store to query: 'ios' for the Apple App Store, 'android' for Google Play.One of: ios, android |
| app_id | string | yes | App identifier, in the format the chosen platform uses: a numeric id for 'ios' (for example 284882215), a reverse-DNS package name for 'android' (for example com.example.app). An identifier in the wrong format is billed rather than rejected, so confirm it before calling: your own web search finds it fastest (site:apps.apple.com "Acme", where the id is the number after /id in the URL), and wuthering_app_search does the same for a billed call. |
| location_code | number | no | Numeric location code to scope results to. Defaults to 2840 (United States). Search volume and competition vary sharply by country, so set this when the question is about a specific market.Defaults to 2840 |
| language_code | string | no | ISO language code for results, for example 'en' or 'de'. Defaults to 'en'.Defaults to en |
| task_id | string | no | Only for resuming, and normally omitted. These store endpoints are queued rather than immediate: the tool submits the request and waits up to 90 seconds for it. That is enough for almost every call, but a large review or chart request can exceed it, in which case the tool fails with a message containing a task id. Passing that id here collects the finished result without submitting, or being billed for, the work a second time. |
Which playbooks call app_details?
1 of the research playbooks name app_details in their method. Each is free to read and says where in the sequence the call belongs.
Reference for app_details · last updated · published by Wuthering AI