Search an app store
app_search is a $0.20 GET request on the Wuthering AI API. Find the apps that rank for a keyword in either app store. It answers complete JSON, and a call that fails is not charged.
Endpoint
GET /v1/app_search
Price per successful call
$0.20
Failed calls
Not charged
curl 'https://wutheringai.com/v1/app_search?platform=…&token=YOUR_TOKEN'
What does app_search return, and when should you call it?
Search the App Store or Google Play for a keyword and return the ranked list of apps.
This is store SEARCH, showing what a shopper sees today. It does not return the keywords an app ranks for, which is wuthering_app_keywords.
Returns: rank_absolute, app_id, title, developer, rating, reviews_count, price, url.
Use to see who owns a category term in a store. Don't use to research one known app, where wuthering_app_details is direct.
What parameters does app_search take?
app_search accepts 6 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 |
| keyword | string | yes | Search term to look up in the store. |
| 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 |
| depth | number | no | Maximum rows to return (1 to 200, default 50). Ask for the fewest that answer the question: every row is billed and spends the caller's context.Defaults to 50 |
| 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_search?
1 of the research playbooks name app_search in their method. Each is free to read and says where in the sequence the call belongs.
Reference for app_search · last updated · published by Wuthering AI