AppSkyline App Rankings

DeleteStop trackedtracking a keyword

PermanentlyUse deletethis awhen trackedsomeone Appskylineasks keywordto bystop id.tracking Idempotentone —of deletingtheir keywords. Returns deleted, or not-found for an already-deletedunknown keywordid isor aone no-op.outside Thisthe stopsaccount. collectingWeekly newrank rankingchecks snapshots;stop historicaland searchpast rowssnapshots instay, theleaving *-searchesa collectionsgap areif notit affected.is tracked again later. Not for pausing tracking temporarily.

 ⟨6 unchanged words⟩ ":{"id":{"description":"Keyword id to delete","maxLength":200,"minLength":1,"type ⟨5 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":false,"title":"DeleteStop trackedtracking a keyword"}

Get app details

FetchUse athis singlewhen Appskylinesomeone appasks byabout id.one Returnsof thetheir appAppSkyline metadataapps, formattedsuch as Markdownwhich (stores it is on or which languages it supports. Returns the app's name, default and supported locales, per-storeApp Store, Mac App Store, Google Play and Microsoft Store ids, creation/editand times).creation and edit times. Not for the live public store page or ratings.

 ⟨5 unchanged words⟩ ,"properties":{"appId":{"description":"AppAppSkyline app id (uuid)","maxLength":200,"minLength ⟨7 unchanged words⟩ 

 ⟨84 unchanged words⟩ :"object"},{"type":"null"}],"description":"Null when the app is not in the signed-in account"},"status":{"enum":["found", ⟨8 unchanged words⟩ 

 ⟨5 unchanged words⟩ false,"readOnlyHint":true,"title":"Get app details"}

Get appdownloads engagementand summaryinstalls

Summarize downloads, installs, uninstalls,Use crashesthis andwhen othersomeone engagementasks totalshow reportedmany bydownloads, ainstalls, storeuninstalls foror onecrashes Appskylinetheir app had over a date window.period. Returns the aggregatestore-reported totals, the mostlatest recent30 daily rows, and the top territories.countries Metricfor namesone differapp perand storestore; becausemetric eachnames storediffer reportsby itsstore. ownNot set.for keyword rankings.

 ⟨5 unchanged words⟩ ,"properties":{"appId":{"description":"AppskylineAppSkyline app id (uuid)","maxLength":200,"minLength":1,"type":"string"},"days":{"description":"Rolling window sizeof inthe last 1 to 365 days, used when no explicit dates are givengiven; omit dates and days for every synced day","exclusiveMinimum":0,"maximum":365,"type":"integer"},"endDate":{"description":"EndLast day of the window as YYYY-MM-DDYYYY-MM-DD; applies only together with startDate","pattern":"^\\d{4}-\\d{2}-\\d ⟨3 unchanged words⟩ :"string"},"startDate":{"description":"StartFirst day of the window as YYYY-MM-DDYYYY-MM-DD; applies only together with endDate

 ⟨75 unchanged words⟩ :"object"},{"type":"null"}],"description":"The most recent 30 days of one daily metric series"},"dataThrough":{"anyOf":[{"maxLength" ⟨25 unchanged words⟩ ,"type":"string"},"topTerritories":{"description":"Up to 8 leading countries or territories by downloads or installs","items":{"maxLength":100,"type":"string"},"maxItems":8,"type":"array"},"totals":{"description":"Store-reported totals for the window; metric names differ by store","items":{"additionalProperties":false,"properties":{ ⟨38 unchanged words⟩ 

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"Get appdownloads engagementand summaryinstalls"}

GetShow keyword rank history

GetUse thethis historicalwhen rankingsomeone timeseriesasks how their app's ranking for ana app,keyword term,has andchanged countryover acrosstime day-by-dayin snapshotsone storedstore byand Appskyline.country. Returns athe Markdownapp's tablerank ofon each date AppSkyline stored a search snapshot, ranknewest first, andup totalto results365 scannedrows; thattracked day.keywords are re-checked weekly. Not for today's live rank.

 ⟨5 unchanged words⟩ ,"properties":{"appId":{"description":"AppskylineAppSkyline app id (uuid)","maxLength":200,"minLength":1,"type":"string"},"country":{"description":"Two-letter store country code (e.g.such as US, or IT (required)","maxLength":10,"minLength":1,"type":"string"},"limit":{"description":"MaximumSnapshots numberto ofreturn, historynewest rowsfirst, from 1 to return365; (newestdefaults first)

 ⟨45 unchanged words⟩ ,"type":"integer"},"snapshots":{"description":"One row per stored search snapshot, newest first; rank is null when the app was not in that snapshot","items":{"additionalProperties":false,"properties":{" ⟨94 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"GetShow keyword rank history"}

GetLook up keyword search-volumesearch overviewvolume

LookUse upthis when someone asks how popular a keyword is or which keyword ideas are worth targeting. Returns monthly searchGoogle web-search volume (a demand proxy, keywordnot app-store search counts), difficulty, CPC and competition level for up to 50 search terms in one country. Values come from Appskyline's shared DataForSEO cache; termsTerms missing or stale infrom the 30-day cache trigger a live, billable upstream lookup, so batch terms rather than callinglookup. onceNot perfor keyword.rankings.

 ⟨6 unchanged words⟩ "country":{"description":"Two-letter country code (e.g.such as US, or IT (required)","maxLength":2,"minLength":2," ⟨7 unchanged words⟩ "lang":{"description":"Two-letter language code (e.g.such as en, it)or it; optional","maxLength":32,"type":"string"},"terms":{"description":"SearchKeyword termsideas to look up (maxin one batch, 1 to 50 perterms callof up to 200 characters, nonone 

 ⟨11 unchanged words⟩ ,"type":"string"},"keywords":{"description":"Google web-search demand per term from the shared 30-day cache, highest volume first; a proxy for interest, not app-store search counts","items":{"additionalProperties":false,"properties":{" ⟨99 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":true,"readOnlyHint":true,"title":"GetLook up keyword search-volumesearch overviewvolume"}

GetCheck an app's keyword rank

Look up theUse currentthis rankingwhen ofsomeone aasks specificwhere Appskylinetheir app ranks for a keyword inright anow givenin one store +and country. Returns "Appthe Xapp's rankslive #Nposition, ofor M"not-ranked, orafter "notscanning inthe top N"50 ifresults theby appdefault doesand notup appearto in200, theand scannedrenders results.a rank card. Not for how a rank changed over time.

 ⟨5 unchanged words⟩ ,"properties":{"appId":{"description":"AppskylineAppSkyline app id (uuid)","maxLength":200,"minLength":1,"type":"string"},"country":{"description":"Two-letter store country code (e.g.such as US, IT)or IT; defaults to US","maxLength":10,"type":"string"},"lang":{"description":"Two-letter language code (e.g.such as en or it; defaults to en except on Google Play, it)which uses the store default","maxLength":32,"type":"string"},"num":{"default":50,"description":"How many search results to scan when looking for the app, (defaultfrom 50,1 max

 ⟨55 unchanged words⟩ :"integer"},{"type":"null"}],"description":"1-based position; null unless status is ranked"},"resultsScanned":{"description":"How many results were scanned; report a rank as #N of this","maximum":200,"minimum":0,"type": ⟨35 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":true,"readOnlyHint":true,"title":"GetCheck an app's keyword rank"}

GetRead publicany app's store listing

Fetch theUse publicthis storewhen listingsomeone forasks anyabout appa bycompetitor's itsor store-nativeany idapp's (notpublic juststore appspage, trackedsuch inas Appskyline):its titlerating, developer,number ratingof ratings, price, version, releaseor dates,last genres,update. andReturns truncatedthe live listing for one store id, with description /and release notes.notes Usefulcut to 600 characters. Not for competitoryour research.own app's synced text per language.

 ⟨5 unchanged words⟩ properties":{"country":{"description":"Two-letter store country code (e.g.such as US, IT)or IT; defaults to the store's own default","maxLength":10,"type":"string"},"lang":{"description":"Two-letter language code (e.g.such as en, it)or it; defaults to the store's own default","maxLength":32,"type":"string"},"store":{"description":"Which storeStore to read: theios-app-store, listingmacos-app-store, fromgoogle-play or microsoft-store","enum":["ios-app-store","macos-app-store"," ⟨3 unchanged words⟩ :"string"},"storeId":{"description":"Store-nativeThe

 ⟨130 unchanged words⟩ :"number"},{"type":"null"}],"description":"Average rating as the store reports it"},"screenshotCount":{"maximum":10000,"minimum" ⟨46 unchanged words⟩ :"object"},{"type":"null"}],"description":"The live public listing; description and release notes are cut to 600 characters. Null when the store has no app with that id."},"status":{"enum":["found", ⟨27 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":true,"readOnlyHint":true,"title":"GetRead publicany app's store listing"}

GetCheck your store listing metadataand review status

ReadUse thethis store-listingwhen metadatasomeone Appskylineasks hasabout syncedtheir forown oneapp's oflisting yourtext appsper —language, persuch localeas namethe title, subtitle, keywords (withor theirrelease characternotes, countor againstwhether Apple'sthe 100-characterlatest limit),version promotionalis text,still releasein notesreview or approved. Returns the metadata AppSkyline last synced for each locale, with the version, andits review state.state Read-only:and itthe neverkeyword downloadsfield's fromlength oragainst uploadsApple's 100-character limit; longer texts are cut to the600 store.characters. Not for a live competitor listing.

 ⟨5 unchanged words⟩ ,"properties":{"appId":{"description":"AppskylineAppSkyline app id (uuid)","maxLength":200,"minLength":1,"type":"string"},"locale":{"description":"Only return this locale, (e.g.written as in the listing such as en-US, it)or it; every synced locale when absent","maxLength":32,"type":"string"},"store":{"description":"Which storeStore listing to read: ios-app-store, macos-app-store, google-play or microsoft-store","enum":["ios-app-store","macos-app-store"," ⟨9 unchanged words⟩ 

 ⟨11 unchanged words⟩ ,"type":"string"},"listings":{"description":"Metadata as last synced into AppSkyline, one row per locale; it may differ from what the store shows now. Long texts are cut to 600 characters.","items":{"additionalProperties":false,"properties":{" ⟨149 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"GetCheck your store listing metadataand review status"}

List your AppSkyline apps

ListUse allthis Appskylinewhen someone asks which apps thethey authenticatedtrack userin hasAppSkyline, accessor to.an Returnsapp's aid Markdownis tableneeded. ofReturns each app's id, name, default locale, and theits per-storeApp idsStore, (iOSMac App Store, Google Play, and Microsoft Store) whenids, set.up to 100 apps. Not for finding other apps in a store.

 ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"apps":{"description":"Apps the signed-in account can access, at most 100","items":{"additionalProperties":false,"properties":{" ⟨49 unchanged words⟩ ],"type":"string"},"truncated":{"description":"True when the account has more than 100 apps","type":"boolean"}},"required":[" ⟨5 unchanged words⟩ 

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"List your AppSkyline apps"}

ListRead recent Google Play reviews

ListUse thethis mostwhen recentsomeone asks what users say about their Android app on Google Play, useror reviewsabout forrecent oneratings ofand yourcomplaints. AppskylineReturns apps:reviews starwith ratingstars, truncatedtext reviewcut textto 300 characters, app version, device, reviewer language, and whether the developer hasreplied, replied.up Requiresto a100 per page. Google Play serviceonly accountreturns configuredreviews forfrom the app.last Paginate7 withdays. theNot returnedfor pageApp token.Store reviews.

 ⟨5 unchanged words⟩ ,"properties":{"appId":{"description":"AppskylineAppSkyline app id (uuid); the app needs a Google Play service account in AppSkyline","maxLength":200,"minLength":1,"type":"string"},"maxResults":{"description":"HowReviews manyto reviewsreturn toper fetchpage, (maxfrom 1 to 100)","exclusiveMinimum":0,"maximum":100,"type":"integer"},"token":{"description":"PagenextPageToken tokenfrom returnedthe byprevious a

 ⟨18 unchanged words⟩ :"string"},{"type":"null"}],"description":"Pass as token to get the next page; null on the last page"},"returned":{"maximum":100,"minimum":0,"type":"integer"},"reviews":{"description":"Reviews created or edited in the last 7 days, as the Google Play API returns them; review text is cut to 300 characters","items":{"additionalProperties":false,"properties":{ ⟨110 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"ListRead recent Google Play reviews"}

List tracked keywords

ListUse trackedthis when someone asks which keywords they track for an Appskylineapp, app.or Returnsbefore aadding Markdownor tabledeleting ofone. Returns each tracked keyword's id, termsearch (searchTerms)term, language, country, and bid, amount.up to 500 per call. Not for current rankings or search volume.

 ⟨5 unchanged words⟩ ,"properties":{"appId":{"description":"App id to listAppSkyline trackedapp keywordsid for(uuid)","maxLength":200,"minLength":1,"type":"string"},"limit":{"description":"MaximumKeywords numberto ofreturn, keywordsfrom 1 to return500; (defaultomit server-side)for all tracked keywords, capped at 500","exclusiveMinimum":0,"maximum":500,"type":"integer"},"skip":{"description":"PaginationKeywords offsetto skip before the first one returned, for paging; defaults to 0

 ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"keywords":{"description":"Tracked keywords for the app, at most 500 per call","items":{"additionalProperties":false,"properties":{" ⟨7 unchanged words⟩ :"number"},{"type":"null"}],"description":"Bid amount stored for the keyword; null when none is set"},"country":{"anyOf":[{"maxLength" ⟨54 unchanged words⟩ ],"type":"string"},"truncated":{"description":"True when more than 500 keywords matched; page with skip","type":"boolean"}},"required":[" ⟨7 unchanged words⟩ 

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"List tracked keywords"}

Search app-storean resultsapp store

RunUse athis livewhen rankedsomeone asks which apps show up for a search againstterm, theor iOSwho their competitors are for a keyword, on the App Store, macOSMac App Store, Google Play, or Microsoft Store via Appskyline without storingStore. aReturns searchthe snapshot.live Returnsresults ain Markdownrank tableorder ofwith rank,store id, title, score,rating and developer (10 by default, up to 200). Not for eachone result.app's own position.

 ⟨5 unchanged words⟩ properties":{"country":{"description":"Two-letter store country code (e.g.such as US, IT)or IT; defaults to US","maxLength":10,"type":"string"},"lang":{"description":"Two-letter language code (e.g.such as en or it; defaults to en except on Google Play, it)which uses the store default","maxLength":32,"type":"string"},"num":{"description":"Number of results to return, (defaultfrom depends1 onto store)200; defaults to 10","exclusiveMinimum":0,"maximum":200,"type":"integer"},"store":{"description":"Which storeStore to search: ios-app-store, macos-app-store, google-play or microsoft-store

 ⟨20 unchanged words⟩ type":"null"}]},"results":{"description":"Live search results in store rank order; nothing is stored in AppSkyline","items":{"additionalProperties":false,"properties":{" ⟨25 unchanged words⟩ :"number"},{"type":"null"}],"description":"Rating score as the store reports it"},"title":{"$ref":"#/properties/results/items/properties/id"}} ⟨30 unchanged words⟩ 1,"type":"string"},"truncated":{"description":"True when the store returned more than 200 results","type":"boolean"}},"required":[" ⟨9 unchanged words⟩ 

 ⟨5 unchanged words⟩ :true,"readOnlyHint":true,"title":"Search app-storean resultsapp store"}

Show Appskyline app overview

RenderUse anthis interactivewhen overviewsomeone forwants a known Appskylinequick app.overview Useof thisone afterof listingthe apps orthey whentrack thein userAppSkyline. providesReturns an Appskylineoverview appcard id.with Itthe showsapp's storeconnected identitiesstores, locales and up to 50 tracked keywords. Not for keyword rankings.

 ⟨3 unchanged words⟩ ,"properties":{"appId":{"description":"AppskylineAppSkyline app id to render(uuid)","maxLength":200,"minLength":1,"type ⟨5 unchanged words⟩ 

 ⟨93 unchanged words⟩ ,"type":"integer"},"keywords":{"description":"The first 50 tracked keywords; keywordCount has the total","items":{"additionalProperties":false,"properties":{" ⟨57 unchanged words⟩ 

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"Show Appskyline app overview"}