apps.apple.com
App Store API
Query public App Store data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.
Query organic results and ads from App Store's native search in Brazil and the United States. 5 credits per call.
GeckoAPI is independent of App Store. This integration reads public data; it does not grant access to private accounts or account management operations.
Available operations
Search apps and ads
apps.apple.com:plp
Query organic results and ads from App Store's native search in Brazil and the United States. 5 credits per call.
5 credits per request
These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.
Coverage and limitations
The query uses native App Store search without an Apple ID. Ad availability varies by keyword, country and time; ads=[] is valid. Pagination is not supported in this version. The response preserves native JSON, whose structure can vary. The abbreviated example comes from a real capture on 27/10/2026 and shows two organic resources and one ad; event metadata and other attributes were omitted only from the example. It does not promise ad delivery or ranking in future requests.
Make your first request
The example uses search apps and ads. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target": "apps.apple.com",
"type": "plp",
"keyword": "spotify",
"region": "BR"
}'Example JSON response
Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.
{
"requestId": "example-request",
"executionId": "example-execution",
"data": {
"source": "apps.apple.com",
"type": "plp",
"query": "spotify",
"region": "BR",
"extractedAt": "2026-10-27T20:20:02.330783Z",
"organicCount": 248,
"adCount": 1,
"ads": [
{
"id": "6477489729",
"type": "apps",
"attributes": {
"name": "Google Gemini",
"artistName": "Google",
"url": "https://apps.apple.com/br/app/google-gemini/id6477489729",
"userRating": {
"ariaLabelForRatings": "4.8 estrelas",
"ratingCount": 934598,
"ratingCountList": [
32496,
7257
],
"value": 4.8
},
"genreDisplayName": "Produtividade"
},
"meta": {}
}
],
"nativeResponse": {
"results": {
"ads-result": {
"data": [
{
"id": "6477489729",
"type": "apps",
"attributes": {
"name": "Google Gemini",
"artistName": "Google",
"url": "https://apps.apple.com/br/app/google-gemini/id6477489729",
"userRating": {},
"genreDisplayName": "Produtividade"
},
"meta": {}
}
]
},
"search": {
"data": [
{
"id": "324684580",
"type": "apps",
"attributes": {
"name": "Spotify: músicas e podcasts",
"artistName": "Spotify",
"url": "https://apps.apple.com/br/app/spotify-m%C3%BAsicas-e-podcasts/id324684580",
"userRating": {},
"genreDisplayName": "Música"
}
},
{
"id": "544007664",
"type": "apps",
"attributes": {
"name": "YouTube",
"artistName": "Google",
"url": "https://apps.apple.com/br/app/youtube/id544007664",
"userRating": {},
"genreDisplayName": "Foto e vídeo"
}
}
]
}
},
"meta": {}
}
}
}Integrate with REST or MCP
Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.
Ready to test the App Store API?
Open the documented example in the sandbox and inspect the response before integrating it into your application.