# API referansı

> https://storelift.net/tr/docs/api/

Tek temel adres, tek anahtar; giden de gelen de JSON. Aşağıdaki her uç, aynı adla bir MCP aracı olarak da var. OpenAPI 3.1: https://storelift.net/openapi.json

## Temel adres

`https://storelift.net/v1`

Aşağıdaki her yol bu adrese görelidir. Okumalar için `GET` gönder; `POST` yalnız `/actions` içindir.

## Kimlik doğrulama

Anahtarı `Authorization: Bearer <key>` ya da `x-api-key` başlığında gönder. Anahtarları Ayarlar › API altında üret; her anahtar kapsamlarını, isteğe bağlı olarak da izinli IP listesini, uygulama listesini ve aylık kredi bütçesini taşır. Bütçesine ulaşan anahtar, ay dönene kadar `402 key_budget_reached` yanıtı verir; öbür anahtarlar çalışmaya devam eder.

REST API için canlı anahtarlar (`sl_live_`) Pro ve üstü planlardadır ya da kredi paketiyle her planda açılır. Free planda yalnız MCP sunucusunda çalışan tek canlı anahtar vardır. Test anahtarları (`sl_test_`) her planda kum havuzu verisini döndürür. Asistanlar her planda [MCP sunucusu](https://storelift.net/tr/mcp-sunucusu/) üzerinden OAuth ile giriş yapar.

## Kredi ve sınırlar

Her çağrı, üzerinde yazan kadar kredi harcar; `/account` ve `/usage` 0 kredidir, bir yazmanın önizlemesi de 0 kredidir. Her yanıt `x-credits-used`, `x-credits-limit`, `x-credits-remaining` ve `x-credits-reset` başlıklarını taşır.

Saniyedeki istek sayısı plana göre belirlenir; aşınca `retry-after` ile birlikte `429 rate_limited` alırsın. Hive uçları satın alınmış API kredisiyle ya da Hive Explorer ile açılır ve ayrıca günlük bir haktan düşer: paket kredisiyle 500 çağrı, Hive Explorer ile 10.000. [Çağrı başına kredi](https://storelift.net/tr/hive/api/)

## Kum havuzu

`https://storelift.net/v1/sandbox`, aşağıda örnek yanıtı olan her okumayı anahtarsız ve kredisiz yanıtlar. Veri sabit ve tarihlidir; bu sayede testler kararlı kalır.

Test anahtarları (`sl_test_`) aynı veriyi canlı temel adreste döndürür ve hiçbir zaman yazmaz.

## Sıra nasıl okunur

Bir sıranın üç hâli vardır ve bunlar birbirine karışmaz: `measured: false` sorgunun o gün ölçülmediğini, `rank: null` ölçüldüğünü ama uygulamanın okunan sonuçların dışında kaldığını gösterir; sayı ise sıranın kendisidir.

## Hatalar

Her hata aynı gövdeyle döner: `{ "error": "<code>", "message": "…", "docs": "…" }`. `error` değişmez; kodunda `message` değerine değil ona göre karar ver. Bazı kodlar `scope`, `field` ya da `limit` gibi alanlar ekler. [Bütün hata kodları](https://storelift.net/tr/docs/api/errors/)

## Örnek işler

Üç iş; ilk çağrıdan saklayacağın sonuca kadar. Her komut kum havuzunda çalışır; bu yüzden kredi harcamaz ve hiçbir şeyi değiştirmez, her yanıt da kum havuzunun o komuta verdiği yanıttır.

Kendi anahtarınla yollar `/sandbox` olmadan aynıdır ve her çağrı üzerinde yazan kadar kredi harcar. Test anahtarı (`sl_test_`) orada da kum havuzu verisiyle, 0 krediyle yanıt verir.

### Bu haftanın kelime sıralarını bir rapora ekle

Bir uygulamanın bir vitrindeki kelimelerini oku ve tek bir satır sakla. Her hafta çalıştır; satırlar alt alta dizilip trendi gösterir.

Kapsam: `apps:read` · Kredi: 2 · kum havuzunda ya da test anahtarıyla 0 · Plan: Kum havuzu ve test anahtarı: her plan · canlı anahtar: Pro ve üstü · Çalıştığı ilk sürüm: API 1.5.0

1. Uygulama kimliğini bul.

```sh
curl "https://storelift.net/v1/sandbox/apps"
```

Yanıt:

```json
{
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "icon": null,
      "iosId": "1000000001",
      "androidPkg": "net.storelift.sandbox.lumen",
      "bundleId": "net.storelift.sandbox.lumen",
      "countries": [
        "us",
        "gb",
        "de"
      ],
      "keywords": [
        "sleep sounds",
        "white noise",
        "rain sounds"
      ],
      "keywordsByCountry": {
        "us": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ],
        "gb": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ],
        "de": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ]
      },
      "manualRivals": null,
      "keywordTags": null,
      "buriedKeywords": null,
      "goal": null,
      "tasksDone": null
    },
    {
      "id": "sbx-quill",
      "name": "Quill Notes",
      "icon": null,
      "iosId": "1000000002",
      "androidPkg": null,
      "bundleId": "net.storelift.sandbox.quill",
      "countries": [
        "us",
        "jp"
      ],
      "keywords": [
        "notes",
        "markdown notes",
        "journal"
      ],
      "keywordsByCountry": {
        "us": [
          "notes",
          "markdown notes",
          "journal"
        ],
        "jp": [
          "notes",
          "markdown notes",
          "journal"
        ]
      },
      "manualRivals": null,
      "keywordTags": null,
      "buriedKeywords": null,
      "goal": null,
      "tasksDone": null
    }
  ]
}
```

2. O uygulamanın o vitrinde izlenen bütün kelimelerini oku.

```sh
curl "https://storelift.net/v1/sandbox/apps/sbx-lumen/keywords?country=us"
```

Yanıt (keywords: 2 / 8 satır):

```json
{
  "country": "us",
  "platform": "ios",
  "live": true,
  "measuredAt": "2026-09-27T02:10:00.000Z",
  "keywords": [
    {
      "term": "sleep sounds",
      "measured": true,
      "rank": null,
      "demand": 73,
      "hintCount": 6,
      "popularity": 73,
      "popularitySource": "p2",
      "popularityWeek": null,
      "popularityNone": false,
      "difficulty": 70,
      "difficultyBand": "brutal",
      "difficultyNone": false,
      "popularityMeasuring": false,
      "difficultyMeasuring": false,
      "measuring": false,
      "searchDepth": 200
    },
    {
      "term": "white noise",
      "measured": true,
      "rank": 57,
      "demand": 37,
      "hintCount": 4,
      "popularity": 37,
      "popularitySource": "p2",
      "popularityWeek": null,
      "popularityNone": false,
      "difficulty": 70,
      "difficultyBand": "brutal",
      "difficultyNone": false,
      "popularityMeasuring": false,
      "difficultyMeasuring": false,
      "measuring": false,
      "searchDepth": 200
    }
  ]
}
```

Yanıtı, sakladığın satıra indirge. `measured: true` ve `rank: null` taşıyan kelime ölçülmüştür, uygulama sonuçlarda yoktur; ölçülmemiş kelimeden ayrı sayılır.

```js
function weeklyRow(body) {
  const ranked = body.keywords.filter((k) => k.measured && k.rank !== null);
  const best = ranked.reduce((a, b) => (a && a.rank <= b.rank ? a : b), null);
  return {
    measuredAt: body.measuredAt,
    country: body.country,
    platform: body.platform,
    keywords: body.keywords.length,
    ranked: ranked.length,
    absent: body.keywords.filter((k) => k.measured && k.rank === null).length,
    notMeasured: body.keywords.filter((k) => !k.measured).length,
    best: best && { term: best.term, rank: best.rank },
  };
}
```

Sonuç:

```json
{
  "measuredAt": "2026-09-27T02:10:00.000Z",
  "country": "us",
  "platform": "ios",
  "keywords": 8,
  "ranked": 6,
  "absent": 2,
  "notMeasured": 0,
  "best": {
    "term": "nature sounds",
    "rank": 29
  }
}
```

Çalışma alanında olmayan bir uygulama kimliği `404` yanıtı alır:

```sh
curl "https://storelift.net/v1/sandbox/apps/sbx-unknown/keywords?country=us"
```

```json
{
  "error": "not_found",
  "message": "No such app in this workspace.",
  "docs": "https://storelift.net/docs/api/errors#not_found"
}
```

### Üstünde kimin sıralandığını sor

Aynı veri, [MCP sunucusu](https://storelift.net/tr/mcp-sunucusu/) üzerinden: asistan iki araç çağrısı yapar. Çağrıları elle göndermek için `STORELIFT_TEST_KEY` değişkenine bir test anahtarı koy.

Kapsam: `apps:read` · Kredi: 2 · test anahtarıyla 0 · Plan: Test anahtarı ve OAuth: her plan · canlı anahtar: her plan · Çalıştığı ilk sürüm: API 1.5.0 · araçlar: storelift-mcp 1.1.1

1. `list_apps` uygulama kimliğini döndürür.

```sh
curl "https://storelift.net/mcp" \
  -H "Authorization: Bearer $STORELIFT_TEST_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_apps","arguments":{}}}'
```

Yanıt:

```json
{
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "icon": null,
      "iosId": "1000000001",
      "androidPkg": "net.storelift.sandbox.lumen",
      "bundleId": "net.storelift.sandbox.lumen",
      "countries": [
        "us",
        "gb",
        "de"
      ],
      "keywords": [
        "sleep sounds",
        "white noise",
        "rain sounds"
      ],
      "keywordsByCountry": {
        "us": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ],
        "gb": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ],
        "de": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ]
      },
      "manualRivals": null,
      "keywordTags": null,
      "buriedKeywords": null,
      "goal": null,
      "tasksDone": null
    },
    {
      "id": "sbx-quill",
      "name": "Quill Notes",
      "icon": null,
      "iosId": "1000000002",
      "androidPkg": null,
      "bundleId": "net.storelift.sandbox.quill",
      "countries": [
        "us",
        "jp"
      ],
      "keywords": [
        "notes",
        "markdown notes",
        "journal"
      ],
      "keywordsByCountry": {
        "us": [
          "notes",
          "markdown notes",
          "journal"
        ],
        "jp": [
          "notes",
          "markdown notes",
          "journal"
        ]
      },
      "manualRivals": null,
      "keywordTags": null,
      "buriedKeywords": null,
      "goal": null,
      "tasksDone": null
    }
  ]
}
```

2. `get_rivals` onun üstünde sıralanan uygulamaları kelime kelime döndürür.

```sh
curl "https://storelift.net/mcp" \
  -H "Authorization: Bearer $STORELIFT_TEST_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_rivals","arguments":{"appId":"sbx-lumen","country":"us"}}}'
```

Yanıt (rivals: 2 / 3 satır):

```json
{
  "country": "us",
  "platform": "ios",
  "rivals": [
    {
      "id": "1000000101",
      "name": "Calm Rain",
      "ratings": 57046,
      "terms": [
        {
          "term": "sleep sounds",
          "theirRank": 1,
          "ourRank": null
        },
        {
          "term": "white noise",
          "theirRank": 1,
          "ourRank": 57
        }
      ]
    },
    {
      "id": "1000000102",
      "name": "Noisli",
      "ratings": 16114,
      "terms": [
        {
          "term": "sleep sounds",
          "theirRank": 2,
          "ourRank": null
        },
        {
          "term": "white noise",
          "theirRank": 2,
          "ourRank": 57
        }
      ]
    }
  ]
}
```

Yanıtın söylediği, rakip rakip. `ourRank: null`, uygulamanın sonuçlarında yer almadığı kelimedir.

```js
function rivalsAhead(body) {
  return body.rivals.map((r) => ({
    name: r.name,
    ratings: r.ratings,
    aheadOn: r.terms.length,
    absentOn: r.terms.filter((t) => t.ourRank === null).length,
  }));
}
```

Sonuç:

```json
[
  {
    "name": "Calm Rain",
    "ratings": 57046,
    "aheadOn": 8,
    "absentOn": 2
  },
  {
    "name": "Noisli",
    "ratings": 16114,
    "aheadOn": 8,
    "absentOn": 2
  },
  {
    "name": "Deep Sleep Tones",
    "ratings": 64683,
    "aheadOn": 8,
    "absentOn": 2
  }
]
```

Çalışma alanında olmayan bir uygulama kimliği başarısız bir istek olarak değil, asistanın okuyabildiği bir araç hatası olarak döner:

```sh
curl "https://storelift.net/mcp" \
  -H "Authorization: Bearer $STORELIFT_TEST_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":9,"method":"tools/call","params":{"name":"get_rivals","arguments":{"appId":"sbx-unknown","country":"us"}}}'
```

```text
ERROR: No such app in this workspace.
```

### Bir kimlik bilgisinin neleri okuyabildiğini HTTP ya da MCP ile gör

Her entegrasyonun ilk çağrısı: hangi plan, hangi kapsamlar, hangi uygulamalar ve kaç kredi kaldı. `GET /account` ile `whoami` aracı aynı gövdeyi döndürür; ikisi de kredi harcamaz.

Kapsam: gerekmez · Kredi: 0 · Plan: Kum havuzu, test anahtarı ve OAuth: her plan · canlı anahtar: Pro ve üstü · Çalıştığı ilk sürüm: API 1.5.0 · araçlar: storelift-mcp 1.5.0

1. HTTP ile.

```sh
curl "https://storelift.net/v1/sandbox/account"
```

Yanıt:

```json
{
  "plan": "studio",
  "auth": "test_key",
  "scopes": [
    "apps:read",
    "reviews:read",
    "ai:read",
    "revenue:read",
    "hive:read",
    "hive:spy",
    "hive:estimate",
    "ads:read"
  ],
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "countries": [
        "us",
        "gb",
        "de"
      ]
    },
    {
      "id": "sbx-quill",
      "name": "Quill Notes",
      "countries": [
        "us",
        "jp"
      ]
    }
  ],
  "appRestriction": false,
  "credits": {
    "used": 0,
    "limit": 50000,
    "resetsAt": null
  },
  "hive": {
    "perDay": 10000
  },
  "ratePerSecond": 10,
  "docs": "https://storelift.net/guide/storelift-api/"
}
```

2. Aynı yanıt, araç çağrısı olarak.

```sh
curl "https://storelift.net/mcp" \
  -H "Authorization: Bearer $STORELIFT_TEST_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"whoami","arguments":{}}}'
```

Yanıt:

```json
{
  "plan": "studio",
  "auth": "test_key",
  "scopes": [
    "apps:read",
    "reviews:read",
    "ai:read",
    "revenue:read",
    "hive:read",
    "hive:spy",
    "hive:estimate",
    "ads:read"
  ],
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "countries": [
        "us",
        "gb",
        "de"
      ]
    },
    {
      "id": "sbx-quill",
      "name": "Quill Notes",
      "countries": [
        "us",
        "jp"
      ]
    }
  ],
  "appRestriction": false,
  "credits": {
    "used": 0,
    "limit": 50000,
    "resetsAt": null
  },
  "hive": {
    "perDay": 10000
  },
  "ratePerSecond": 10,
  "docs": "https://storelift.net/guide/storelift-api/"
}
```

Bir çağrıyı yapmadan önce gerektirdiği kapsama bak; toplu bir işe başlamadan önce de bakiyeyi oku.

```js
function allowance(body) {
  return {
    plan: body.plan,
    auth: body.auth,
    scopes: body.scopes,
    apps: body.apps.map((a) => a.id),
    creditsLeft: body.credits.limit - body.credits.used,
    ratePerSecond: body.ratePerSecond,
  };
}
```

Sonuç:

```json
{
  "plan": "studio",
  "auth": "test_key",
  "scopes": [
    "apps:read",
    "reviews:read",
    "ai:read",
    "revenue:read",
    "hive:read",
    "hive:spy",
    "hive:estimate",
    "ads:read"
  ],
  "apps": [
    "sbx-lumen",
    "sbx-quill"
  ],
  "creditsLeft": 50000,
  "ratePerSecond": 10
}
```

Kimlik bilgisi olmadan MCP ucu `401` ile birlikte bir JSON-RPC hatası döndürür; MCP yetkilendirmesini destekleyen istemci OAuth girişini bu yanıttan başlatır:

```sh
curl "https://storelift.net/mcp" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":9,"method":"tools/call","params":{"name":"whoami","arguments":{}}}'
```

```json
{
  "jsonrpc": "2.0",
  "id": 9,
  "error": {
    "code": -32001,
    "message": "No credentials were sent. Sign in with OAuth on any plan, or add Authorization: Bearer <your Storelift API key>. Live keys require Pro, Studio, Enterprise, or an eligible Free account with purchased API credits or active Explorer. Tool access still depends on plan, scopes and credits. Generate a key at Storelift → Settings → API keys."
  }
}
```

## Ortak parametreler

Bunlar, kabul eden her uçta aynı anlama gelir; her uç kabul ettiklerini kendi listesinde gösterir.

- `appId` (path, string) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `platform` (query, ios | android) — varsayılan ios
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)

## [Hesap](https://storelift.net/tr/docs/api/account/)

Anahtarın kendi planı, kapsamları ve kullanımı, hesap içi arama ve uyarı akışı. Planı ve kullanımı okumak 0 kredi.

- [`GET /alerts`](https://storelift.net/tr/docs/api/account/#list_alerts) — Bu çalışma alanının uyarı akışı — sıra düşüşleri ve yükselişleri, sonuçlara giren ya da sonuçlardan… (1)
- [`GET /portfolio`](https://storelift.net/tr/docs/api/account/#get_portfolio_overview) — Çalışma alanındaki bütün uygulamalarda bugün, uygulama başına bir satır: canlı kullanıcılar… (2)
- [`GET /account`](https://storelift.net/tr/docs/api/account/#whoami) — Bu anahtarın ya da oturumun kime ait olduğu: plan, nasıl kimlik doğruladığı, taşıdığı kapsamlar… (0)
- [`GET /usage`](https://storelift.net/tr/docs/api/account/#get_usage) — Çalışma alanının bütün kotaları, kullanılan miktar ve sıfırlanma zamanıyla: izlenen kelimeler… (0)
- [`GET /search`](https://storelift.net/tr/docs/api/account/#search) — Bu hesabın kendi kayıtlarında ara — uygulama adları ve mağaza kimlikleri, izlenen kelimeler ve… (1)
- [`GET /fetch`](https://storelift.net/tr/docs/api/account/#fetch) — search'ten gelen bir kimliğin arkasındaki tam kayıt: bir uygulama kartı, güncel durumu ve sıra… (1)

## [Uygulamaların](https://storelift.net/tr/docs/api/apps/)

Bu çalışma alanının izlediği uygulamalar: sıralar, rakipler, yorumlar, mağaza sayfası, künye zaman çizelgesi, öne çıkarılmalar, listeler ve künye denetimleri.

- [`GET /apps`](https://storelift.net/tr/docs/api/apps/#list_apps) — Bu Storelift hesabında izlenen uygulamaları listele (kimlik, ad, ülkeler, kelimeler) (1)
- [`GET /apps/{appId}/keywords`](https://storelift.net/tr/docs/api/apps/#get_keywords) — Bir uygulamanın tek bir App Store / Google Play ülkesindeki kelime sıraları (1)
- [`GET /apps/{appId}/rivals`](https://storelift.net/tr/docs/api/apps/#get_rivals) — Aramada bu uygulamanın ÜSTÜNDE sıralanan uygulamalar (1)
- [`GET /apps/{appId}/ai`](https://storelift.net/tr/docs/api/apps/#get_ai_visibility) — Yapay zekâ motorlarının cevaplarından alınmış tarihli bir örnekteki uygulama anmaları; ChatGPT, Claude… (1)
- [`GET /apps/{appId}/ai-check`](https://storelift.net/tr/docs/api/apps/#run_ai_visibility_check) — Bir uygulama için tek bir ülkede, o turda kullanılabilen motorlarla bir AI görünürlük örneği başlat.… (1)
- [`GET /apps/{appId}/history`](https://storelift.net/tr/docs/api/apps/#get_history) — Tek bir ülke için kelime sıra geçmişi (1)
- [`GET /apps/{appId}/page`](https://storelift.net/tr/docs/api/apps/#get_store_page) — Uygulamanın tek bir ülkedeki kendi mağaza sayfası sinyalleri (ad ve alt başlık dahil değildir): sürüm… (1)
- [`GET /apps/{appId}/reviews`](https://storelift.net/tr/docs/api/apps/#get_reviews) — Tek bir ülkenin son yorumları: `list` App Store yorumlarını, `android` Google Play yorumlarını tutar… (1)
- [`GET /apps/{appId}/charts`](https://storelift.net/tr/docs/api/apps/#get_charts) — Tek bir ülke için App Store liste konumu: liste başına güncel sıralar (ücretsiz / ücretli / en çok… (1)
- [`GET /apps/{appId}/reviews/search`](https://storelift.net/tr/docs/api/apps/#search_reviews) — Bir uygulamanın tek bir vitrindeki yorumlarında metne, yıldız puanına, uygulama sürümüne ve tarih… (1)
- [`GET /apps/{appId}/reviews/stats`](https://storelift.net/tr/docs/api/apps/#get_review_stats) — Bir uygulamanın tek bir vitrindeki yıldız dağılımı, ortalaması ve 1–2 yıldızlı yorum payı; ayrıca gün… (1)
- [`GET /apps/{appId}/reviews/summary`](https://storelift.net/tr/docs/api/apps/#summarize_reviews) — Bir uygulamanın tek bir vitrini için Yorum AI: son yorumların özeti ve içlerindeki temalar… (1)
- [`GET /apps/{appId}/reviews/reply-draft`](https://storelift.net/tr/docs/api/apps/#draft_review_reply) — Tek bir yorum için vitrinin dilinde geliştirici cevabı taslağı (1)
- [`GET /apps/{appId}/timeline`](https://storelift.net/tr/docs/api/apps/#get_listing_timeline) — Bir uygulamanın mağaza sayfasındaki tarihli değişiklikler — yeni sürüm, ekran görüntüleri, uygulama içi… (1)
- [`GET /apps/{appId}/today`](https://storelift.net/tr/docs/api/apps/#get_today) — Bir uygulamanın günü tek cevapta — Bugün ekranı: bağlı kaynaklardan satın almalar, denemeler ve… (1)
- [`GET /apps/{appId}/competition`](https://storelift.net/tr/docs/api/apps/#get_keyword_competition) — Tek bir vitrinde her kelimede kaç uygulamanın rekabet ettiği; iki ya da daha fazla uygulamada görülen terimler için döner (1)
- [`GET /apps/{appId}/rivals/{rivalId}`](https://storelift.net/tr/docs/api/apps/#get_rival_detail) — Uygulamanın tek bir vitrindeki bir rakibi: adı, puanı ve puan sayısı ile bunların 90 günlük geçmişi… (1)
- [`GET /apps/{appId}/rivals/{rivalId}/adnetworks`](https://storelift.net/tr/docs/api/apps/#get_rival_ad_networks) — Bir rakibin reklamla nasıl para kazandığı: çalıştığı reklam ağları, her biri DIRECT ya da RESELLER olarak işaretli (1)
- [`GET /apps/{appId}/rivals/{rivalId}/market`](https://storelift.net/tr/docs/api/apps/#get_rival_market) — Bir rakibin tek bir vitrindeki pazarı: Google Play'de tam kurulum sayısı ve uygulama içi satın alma… (1)
- [`GET /apps/{appId}/storefront-audit`](https://storelift.net/tr/docs/api/apps/#get_storefront_audit) — iOS mağaza sayfan bütün App Store vitrinlerinde: uygulamanın nerede satıldığı, hangi vitrinlerin kendi… (1)
- [`GET /apps/{appId}/suggest`](https://storelift.net/tr/docs/api/apps/#suggest_keywords) — Bir uygulama için tek bir vitrinde, o vitrinin arama dilinde yazılmış yeni kelime fikirleri: insanların… (1)
- [`POST /apps/{appId}/validate-listing`](https://storelift.net/tr/docs/api/apps/#validate_listing) — Bir App Store mağaza sayfası taslağını App Store Connect'e gitmeden önce denetle (1)
- [`GET /apps/{appId}/draft`](https://storelift.net/tr/docs/api/apps/#draft_listing) — Bir mağaza sayfası taslağı — başlık, alt başlık, tanıtım metni ve açıklama — bu uygulama için tek bir… (1)
- [`GET /apps/{appId}/localize`](https://storelift.net/tr/docs/api/apps/#localize_listing) — Yeni bir dil için App Store mağaza sayfasının tamamını yaz — ad, alt başlık, kelime alanı ve açıklama… (1)
- [`GET /apps/{appId}/shot-text`](https://storelift.net/tr/docs/api/apps/#get_screenshot_text) — Tek bir vitrindeki ilk dört App Store ekran görüntünün üzerindeki yazılar (1)
- [`GET /apps/{appId}/chart-movers`](https://storelift.net/tr/docs/api/apps/#get_chart_movers) — Uygulamanın kendi kategori listesinde kimler hareket etti: yükselenler ve düşenler (3+ basamak), yeni… (1)
- [`GET /apps/{appId}/featuring`](https://storelift.net/tr/docs/api/apps/#get_featuring) — Apple'ın uygulamayı bugün nerede gösterdiği, ülke ülke: editoryal kartlar (dedicated: true hikâye bu… (1)
- [`GET /apps/{appId}`](https://storelift.net/tr/docs/api/apps/#get_app) — İzlenen tek bir uygulama; platform kimlikleri, ülkeleri, ülke başına izlenen kelimeleri ve en son ölçüm… (1)
- [`GET /apps/{appId}/weekly-plan`](https://storelift.net/tr/docs/api/apps/#get_weekly_plan) — Uygulama için bu haftanın mağaza sayfası önerileri — paneldeki “Bu hafta” kartıyla aynı liste, en iyisi en üstte (1)

## [Gelir ve Apple Ads](https://storelift.net/tr/docs/api/growth/)

Uygulama başına bağlı kaynaklar: gelir, abonelik olayları, App Store hunisi, fiyatlar ve teklif kodları, bir değişikliğin öncesi ve sonrası; Apple Ads kampanyaları, kelimeleri, arama terimleri ve komutları. Kapsamlar: revenue:read ve ads:read.

- [`GET /apps/{appId}/revenue`](https://storelift.net/tr/docs/api/growth/#get_revenue) — Bir uygulamanın, kullanıcının bağladığı kaynaklardan gelen geliri ve indirmeleri: App Store Connect'ten… (1)
- [`GET /apps/{appId}/subscriptions`](https://storelift.net/tr/docs/api/growth/#get_subscription_events) — Bir uygulama için RevenueCat / Adapty webhook'undan gelen abonelik olayı sayıları: gün ve ülke bazında… (1)
- [`GET /apps/{appId}/funnel`](https://storelift.net/tr/docs/api/growth/#get_store_funnel) — Bir uygulamanın App Store Connect analitiğinden gelen App Store dönüşüm hunisi: gösterimler → ürün… (1)
- [`GET /apps/{appId}/campaigns`](https://storelift.net/tr/docs/api/growth/#get_ads_campaigns) — Bir uygulamayı tanıtan Apple Ads kampanyaları (ada göre değil, uygulamanın App Store kimliğine göre… (1)
- [`GET /apps/{appId}/ads-keywords`](https://storelift.net/tr/docs/api/growth/#get_ads_keywords) — Bir uygulama için kampanyalarının tamamında satın alınan bütün Apple Ads kelimeleri (son 28 gün)… (1)
- [`GET /apps/{appId}/ads-search-terms`](https://storelift.net/tr/docs/api/growth/#get_ads_search_terms) — İnsanların gerçekten yazdığı ve uygulamanın Apple Ads reklamlarını tetikleyen aramalar (son 28 gün)… (1)
- [`GET /apps/{appId}/ads-commands`](https://storelift.net/tr/docs/api/growth/#get_ads_command_status) — Bir uygulamanın kampanyaları için Apple Ads komutları — panelden, otomasyon kurallarından ve… (1)
- [`GET /apps/{appId}/search-popularity`](https://storelift.net/tr/docs/api/growth/#get_search_popularity) — Apple'ın kendi arama popülerliği, bu çalışma alanına bağlı Apple Ads hesabından: uygulamanın kategorisi… (1)
- [`GET /apps/{appId}/pricing`](https://storelift.net/tr/docs/api/growth/#get_pricing_offers) — Bir uygulamanın RevenueCat ya da Adapty webhook'undan gelen ürün fiyatları ve offer code'ları, son 365… (1)
- [`GET /apps/{appId}/country-prices`](https://storelift.net/tr/docs/api/growth/#get_country_prices) — Uygulamanın bir ürünü için ülke fiyatları, App Store Connect / Google Play'den okunur (Pro): ülke… (1)
- [`GET /apps/{appId}/change-impact`](https://storelift.net/tr/docs/api/growth/#get_change_impact) — Bir değişikliğin ne yaptığı: tek bir değişiklik günü için (yeni sürüm, ekran görüntüleri, alt başlık… (1)

## [Hive](https://storelift.net/tr/docs/api/hive/)

Storelift ağının ölçtüğü herhangi bir uygulama ya da pazar; sen izlesen de izlemesen de. Hive Explorer'ın parçası.

- [`GET /rank-check`](https://storelift.net/tr/docs/api/hive/#check_rank) — Uygulamalarından birinin tek bir vitrinde herhangi bir arama terimindeki canlı sırası, mağazanın şu… (10)
- [`GET /keyword-difficulty`](https://storelift.net/tr/docs/api/hive/#get_keyword_metrics) — Tek bir vitrinde bir App Store arama terimi için talep ve zorluk girdileri: talebi (`demand`) ve ilgili… (10)
- [`GET /hive/find`](https://storelift.net/tr/docs/api/hive/#find_apps) — Ölçtüğümüz üst listelerde uygulama bul: kategoriye, vitrine, listeye (Top Grossing, Top Free, Top Paid… (20)
- [`GET /hive/charts`](https://storelift.net/tr/docs/api/hive/#market_charts) — Son ölçtüğümüz hâliyle tek bir üst liste: bir vitrin, liste türü ve isteğe bağlı kategori için sıralı… (10)
- [`GET /hive/movers`](https://storelift.net/tr/docs/api/hive/#market_movers) — Tek bir üst listede kim yükseldi, kim düştü, kim girdi, kim çıktı; N gün önceki aynı listeye göre (10)
- [`GET /hive/new`](https://storelift.net/tr/docs/api/hive/#market_new_apps) — Bir üst listede ilk kez görülen uygulamalar, en yeni en üstte, her birinin arkasındaki yayıncıyla (10)
- [`GET /hive/publisher/{publisherId}`](https://storelift.net/tr/docs/api/hive/#market_publisher) — Bir yayıncının bir listede gördüğümüz bütün uygulamaları, her birinin ilk görüldüğü günle (10)
- [`GET /hive/resolve`](https://storelift.net/tr/docs/api/hive/#hive_search_apps) — Herhangi bir uygulamanın kimliğini bul: ada ya da geliştiriciye göre (o vitrindeki en iyi eşleşmeler… (10)
- [`GET /hive/similar/{appId}`](https://storelift.net/tr/docs/api/hive/#hive_similar_apps) — Herhangi bir uygulama için mağazanın kendi benzer uygulamalar rafı (Apple'ın You Might Also Like… (10)
- [`GET /hive/reviews/{appId}`](https://storelift.net/tr/docs/api/hive/#hive_app_reviews) — Herhangi bir uygulamanın tek bir vitrindeki son yorumları, en yeni en üstte: yıldız, başlık, metin… (10)
- [`POST /hive/keywords/{term}/metrics/measure`](https://storelift.net/tr/docs/api/hive/#hive_measure_keyword_metrics) — Saklanan değer eksik ya da eskiyse, tek bir vitrinde bir kelimenin popülerliği ve/veya zorluğu için… (50)
- [`GET /hive/apps/{id}`](https://storelift.net/tr/docs/api/hive/#hive_app_details) — Herhangi bir uygulamanın en son günlük ölçümü (10)
- [`GET /hive/keywords/{term}/ranks`](https://storelift.net/tr/docs/api/hive/#hive_keyword_ranks) — Bir kelimede kimlerin sıralandığı, gün gün (10)
- [`GET /hive/keywords/{term}/metrics`](https://storelift.net/tr/docs/api/hive/#hive_keyword_metrics) — Bir kelimenin güncel popülerliğini ve zorluğunu oku (10)
- [`GET /hive/keywords/{term}/metrics/history`](https://storelift.net/tr/docs/api/hive/#hive_keyword_metrics_history) — Saklanan kelime metriği gözlemlerini zaman içinde oku (20)
- [`GET /hive/spy/{id}`](https://storelift.net/tr/docs/api/hive/#hive_keyword_spy) — Herhangi bir uygulamanın sıralandığı kelimeler (200)
- [`GET /hive/estimate/{id}`](https://storelift.net/tr/docs/api/hive/#hive_estimate) — Herhangi bir uygulamanın geliri ve indirmeleri (500)
- [`GET /hive/gap`](https://storelift.net/tr/docs/api/hive/#get_keyword_gap) — Birkaç uygulama arasında kelime boşluğu (400)
- [`GET /hive/research`](https://storelift.net/tr/docs/api/hive/#hive_keyword_research) — Bir tohum terimden kelime araştırması (50)
- [`GET /hive/landscape`](https://storelift.net/tr/docs/api/hive/#hive_category_landscape) — Bir kategoride sıralanmak için ne gerekir (10)

## [Yazma](https://storelift.net/tr/docs/api/actions/)

Her yazma iki adımda çalışır: önce hiçbir şeyi değiştirmeyen bir önizleme, ardından önizlemenin döndürdüğü jetonla onay.

- [`GET /jobs/{jobId}`](https://storelift.net/tr/docs/api/actions/#get_job) — Onaylanmış bir eylemin başlattığı uzun süren işin durumu (Apple Ads komutu, yorum cevabı, mağaza… (0)
- [`POST /actions`](https://storelift.net/tr/docs/api/actions/#preview_action) — Bir yazmayı önizle (0)
- [`POST /actions/confirm`](https://storelift.net/tr/docs/api/actions/#confirm_action) — Önizlemesi yapılmış bir yazmayı uygula (eyleme göre)