---
title: "App"
description: "Google Play에서 앱 페이지를 가져옵니다."
---
> Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt)
```http
GET | POST /v1/google-play/app
```
파라미터는 `GET`의 쿼리 문자열로도, `POST`의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.
## 요청
```bash tab="cURL"
curl "https://gateway.apinoa.com/v1/google-play/app?id=com.strava&country=US" \
-H "x-api-key: $APINOA_API_KEY"
```
```js tab="JavaScript"
const params = new URLSearchParams({ id: "com.strava", country: "US" });
const res = await fetch(`https://gateway.apinoa.com/v1/google-play/app?${params}`, {
headers: { "x-api-key": process.env.APINOA_API_KEY },
});
const { success, data, error } = await res.json();
```
```python tab="Python"
import os
import requests
res = requests.get(
"https://gateway.apinoa.com/v1/google-play/app",
params={"id": "com.strava", "country": "US"},
headers={"x-api-key": os.environ["APINOA_API_KEY"]},
)
body = res.json()
```
## 파라미터
| Parameter | Type | Required | Notes |
|---|---|---|---|
| `country` | enum | | The market, as an ISO 3166 country code. `US` `GB` `CA` `AU` `NZ` `IE` `DE` `FR` `IT` `ES` `NL` `BE` `AT` `CH` `SE` `NO` `DK` `FI` `PL` `PT` `CZ` `GR` `HU` `RO` `TR` `UA` `IL` `AE` `SA` `EG` `ZA` `NG` `KE` `IN` `PK` `ID` `MY` `SG` `TH` `VN` `PH` `JP` `KR` `TW` `HK` `MX` `BR` `AR` `CL` `CO` `PE` |
| `id` | string | | The app's Play id: its package name (`com.strava`). |
| `lang` | string | | Interface language. |
| `url` | string | | The app's Play link, instead of `id`. |
The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json
## 응답
`data`에 [`App`](/docs/api-reference/serp/response-schema#app)를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.
```json
{
"success": true,
"data": {
"id": "com.strava",
"name": "Strava: Run, Bike, Walk",
"url": "https://play.google.com/store/apps/details?id=com.strava",
"developer": {
"id": "4627506231732616211",
"name": "Strava Inc.",
"url": "https://play.google.com/store/apps/developer?id=Strava+Inc.",
"website": "https://www.strava.com/",
"email": "support@strava.com",
"address": "181 Fremont St FL 27\nSan Francisco, CA 94105-2207\nUnited States"
},
"icon": "https://play-lh.googleusercontent.com/J4LN2qH2PQkZ3sFQonz-HWYkd7M38BtEO4Grzh1Xn7L2J6NUILHP…",
"screenshots": ["https://play-lh.googleusercontent.com/A6tzOmAEAZMirzO_o7ddyHn_100dCu9z5FeApDZkCTjqG2eX8dao…"],
"summary": "Track your active life in one place and share the journey with friends.",
"description": "Join over 180 million active people on Strava – the free app where building community meet…",
"categories": ["Health & Fitness"],
"rating": {
"average": 4.5945516,
"count": 1209062,
"distribution": {"1": 5.55, "2": 1.46, "3": 2.7, "4": 8.58, "5": 81.72}
},
"price": {"currency": "USD", "amount": 0},
"inAppPurchases": true,
"contentRating": "Teen",
"version": "487.11",
"releasedAt": "2011-06-09T21:09:54.000Z",
"updatedAt": "2026-10-27T17:54:25.000Z",
"whatsNew": "Hi there. We fixed a couple bugs and made some performance improvements, so the app should…",
"starCounts": {"1": 67059, "2": 17647, "3": 32636, "4": 103710, "5": 987987},
"editorsChoice": true,
"related": [
{
"id": "homeworkout.homeworkouts.noequipment",
"name": "Home Workout - No Equipment",
"url": "https://play.google.com/store/apps/details?id=homeworkout.homeworkouts.noequipment",
"developer": {"name": "Leap Fitness Group"},
"icon": "https://play-lh.googleusercontent.com/NlQFS5pgo96dzbRuwZfkBhGf3ecKSGH5lRx0DSsmELYZXRYHlXrd…",
"screenshots": ["https://play-lh.googleusercontent.com/Udi5jdaiqs8plPZwfnI5eH3FpjDDgK6wtQo-3POLE6um6Annm6vu…"],
"description": "Build muscle, lose weight, gain strength, and increase height with Home Workouts through e…",
"categories": ["Health & Fitness"],
"rating": {"average": 4.860637},
"price": {"currency": "USD", "amount": 0},
"inAppPurchases": true,
"contentRating": "Everyone",
"ext": {
"inAppPriceRange": "$2.99 - $69.99 per item",
"installs": "100,000,000+",
"minInstalls": 100000000,
"ratingText": "4.9",
"headerImage": "https://play-lh.googleusercontent.com/7dcnj4_NE2eeKT8_ZzbtyRFC52dHy5jrgzofe2XMG9tQ7tRC83uY…",
"contentRatingDescription": "Content is generally suitable for all ages. May contain minimal cartoon, fantasy or mild v…",
"descriptionHtml": "Build muscle, lose weight, gain strength, and increase height…"
}
}
],
"privacyPolicyUrl": "https://www.strava.com/privacy",
"chart": {"name": "top grossing health & fitness", "position": 4},
"ext": {
"inAppPriceRange": "$2.99 - $249.99 per item",
"installs": "100,000,000+",
"minInstalls": 100000000,
"ratingText": "4.6",
"reviewCount": 34487,
"ratingsByDevice": {"phone": 4.6145573, "tablet": 4.483731, "watch": 4.0507097, "chromebook": 4.21},
"installCount": 136896139,
"installsShort": "100M+",
"categoryId": "HEALTH_AND_FITNESS",
"categoryIds": ["HEALTH_AND_FITNESS"],
"developerContact": {"legalName": "Strava, Inc.", "email": "phonesupport@strava.com", "phone": "+1 415-320-7817"},
"interactiveElements": "Users Interact, Shares Location, In-App Purchases",
"permissions": [{"group": "Identity", "permissions": ["find accounts on the device"]}],
"dataSafety": [
{
"statement": "This app may share these data types with third parties",
"detail": "App info and performance and Device or other IDs"
}
],
"targetSdk": 36,
"headerImage": "https://play-lh.googleusercontent.com/D7gInUs6uPbJEqpkODMRsL9v042OwdAkcjgdsiSAUFYolQkeRVfm…",
"released": "Jun 9, 2011",
"updated": "Oct 27, 2026",
"descriptionHtml": "Join over 180 million active people on Strava – the free app where building community m…",
"phoneRating": {
"average": 4.6145573,
"count": 1188432,
"reviewCount": 33890,
"starCounts": {"1": 61529, "2": 16191, "3": 30764, "4": 101801, "5": 978113}
},
"events": [
{
"title": "October 10k Challenge",
"status": "Ends in 23h",
"url": "https://play.google.com/store/apps/eventdetails/4831046910425965663",
"image": "https://play-lh.googleusercontent.com/8C_VLv8U2TPVBHn5GlajOhsMd95L7JsBPifFNChZWvaJbeKZQ_Bc…"
}
],
"reviews": [
{
"id": "a060af74-12c9-4359-a779-fe0560d54d96",
"author": "Greg Gidden",
"rating": 1,
"body": "Used to work great, but after the recent update a couple weeks ago the app is no longer wo…",
"date": "2025-07-20T15:30:54.000Z",
"helpfulCount": 631,
"images": [],
"ext": {
"authorAvatarUrl": "https://play-lh.googleusercontent.com/a-/ALV-UjXq0_JWMUg-Da6c9DfCCCKHYY1_ke_jR-xUroY0ZzdX2…",
"authorId": "108049197622652298322",
"appVersion": "419.12",
"device": "phone"
}
}
]
},
"country": "US"
}
}
```
## 에러
| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | `INVALID_PARAMS` | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났거나, 이 엔진이 받지 않는 값입니다. 메시지에 이름이 나옵니다. |
| 401 | `UNAUTHORIZED` | `x-api-key` 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | `INSUFFICIENT_BALANCE` | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 404 | `NOT_FOUND` | 이 스토어의 해당 시장에 그 앱이 없습니다. |
| 429 | `MARKETPLACE_SATURATED` | 동시 호출이 너무 많습니다. `Retry-After` 초만큼 기다린 뒤 다시 시도하세요. |
| 502 | `UPSTREAM_ERROR` | 엔진이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요. |
| 503 | `SERVICE_UNAVAILABLE` | 일시적인 장애입니다. 간격을 두고 다시 시도하세요. |
모든 코드는 [Errors](/docs/errors)에 있습니다. 실패한 호출은 과금되지 않습니다.
## 가격
**Price** $0.0012 per call. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day.
## 참고
- 앱의 패키지 이름(`com.strava`)을 넘기거나 Play 링크를 `url`로 넘깁니다.