İçeriğe geç

App Store Connect API

App Store Connect satıcı numarası ve salesReports API’si

App Store Connect API’sine yapılan her satış raporu isteği, çoğu geliştiricinin hiç bakmadığı bir sayıyı ister: satıcı numarası. Bu rehberde nerede durduğunu, hangi anahtarın kullanabildiğini ve `GET /v1/salesReports` çağrısını gerçekten işinize yarayan ülke bazlı satışlara nasıl çevireceğinizi bulacaksınız.

Güncellendi: 9 dk okuma

App Store Connect satıcı numaranızı nerede bulursunuz?

Satıcı numaranız Ödemeler ve Finansal Raporlar bölümündedir. App Store Connect’te oturum açın, Ödemeler ve Finansal Raporlar’ı açın, sayfanın üstünden Raporlar’ı seçin; numara sol üst köşede Yasal Kuruluş Adınızın altında görünür. API bunu filter[vendorNumber] olarak bekler (Apple’ın yardım sayfası).

  1. App Store Connect’te Account Holder, Admin veya Finance rolüyle oturum açın — Apple’ın Ödemeler ve Finansal Raporlar için saydığı roller bunlardır.
  2. Ödemeler ve Finansal Raporlar’ı açın.
  3. Sayfanın üstünden Raporlar’ı seçin.
  4. Satıcı numarasını sol üstte Yasal Kuruluş Adınızın altından okuyun ve kopyalayın.

İki kısa yol. Trendler → Satışlar ve Eğilimler Raporları’ndan hiç satış raporu indirdiyseniz satıcı numarası dosya adındadır: günlük özet dosyaları S_D_<vendor number>_<date> biçiminde adlandırılır, örneğin S_D_80012345_20130919 (rapor dosya adları). Yalnızca Sales rolünüz varsa, finans sayfasında gösterildiği için Admin veya Finance rolündeki birinden sizin için okumasını isteyin.

Birden fazla satıcı numarası

Satıcı adınızın yanındaki menü birden fazla satıcı numarası listeleyebilir. Apple, Yasal Kuruluş Adınızı değiştirdiğinizde yeni bir numara verir; Apple News+ veya Apple Arcade sözleşmeleri için de ayrı numaralar verir. Raporlar satıcı numarasına göre bölünür, bu yüzden yasal ad değişikliğinden sonra yeni satışlar için yeni numaraya, geçmiş için eski numaraya ihtiyacınız olur.

Satış raporlarını hangi roller okuyabilir?

İki farklı izin söz konusudur: satıcı numarasını görmek (Ödemeler ve Finansal Raporlar) ve Satışlar ve Eğilimler’i okumak. Raporları indiren API anahtarının ikincisine ihtiyacı vardır. Apple’ın rol izinleri ve yardım sayfalarından:

RolSatışlar ve Eğilimler raporlarıÖdemeler ve Finansal RaporlarFiyat değiştirme
AdminEvetEvetEvet
FinanceEvetEvetHayır
SalesEvetHayırHayır
App ManagerApple listelemiyorHayırEvet
Developer, Marketing, Customer SupportHayırHayırHayır

Apple, yalnızca raporları analiz eden bir üçüncü tarafa vereceğiniz anahtar için Sales rolünü önerir (API belgelerinde Sales and Reports olarak geçer): GET /v1/salesReports çağrısını yapabilir ama finans raporları uç noktasını çağıramaz (Apple’ın notu). Tek bir anahtar hem satışları okuyup hem fiyat değiştirecekse, ikisini de yapan tek anahtar rolü Admin’dir. Alternatif iki anahtardır — fiyatlandırma için App Manager, raporlar için Sales — aracınız destekliyorsa bu daha düzenlidir. İkisinin de nasıl oluşturulacağı API anahtarı oluşturma rehberindedir.

Satışlar ve Eğilimler rapor türleri

GET /v1/salesReports indirilebilir tüm Satışlar ve Eğilimler raporlarını sunar. Her tür yalnızca belirli alt tür, sıklık ve sürüm kombinasyonlarını kabul eder; başka her şey hatadır. Geçerli kombinasyonlar, Apple’ın uç nokta başvurusundan:

reportTypereportSubTypefrequencyversion
SALESSUMMARYDAILY, WEEKLY, MONTHLY, YEARLY1_0
PRE_ORDERSUMMARYDAILY, WEEKLY, MONTHLY, YEARLY1_0
SUBSCRIPTIONSUMMARYDAILY1_3
SUBSCRIPTION_EVENTSUMMARYDAILY1_3
SUBSCRIBERDETAILEDDAILY1_3
SUBSCRIPTION_OFFER_CODE_REDEMPTIONSUMMARYDAILY1_0
WIN_BACK_ELIGIBILITYSUMMARYDAILY1_0
NEWSSTANDDETAILEDDAILY, WEEKLY1_0
FIRST_ANNUALDETAILED / SUMMARYDAILY / YEARLY1_0

Ülke bazlı satışlar için aradığınız SALES / SUMMARY’dir: uygulamalar ve uygulama içi satın almalar için toplanmış birimler, fiyatlar ve gelir; her ürün, ülke, fiyat ve işlem türü için bir satır. Günlük en yararlı sıklıktır, çünkü herhangi bir dönemi günlerden yeniden kurabilirsiniz ve bir fiyat değişikliğinin etkisini görmek için gereken şey günlerdir.

GET /v1/salesReports ile satış raporu indirme

ParametreZorunluGünlük satış raporu için değerNotlar
filter[vendorNumber]Evet85012345 (sizinki)Ödemeler ve Finansal Raporlar’dan.
filter[reportType]EvetSALESDiğer türler için yukarıdaki tabloya bakın.
filter[reportSubType]EvetSUMMARYRapor türüyle eşleşmeli.
filter[frequency]EvetDAILYDAILY, WEEKLY, MONTHLY veya YEARLY.
filter[reportDate]Hayır2026-11-09Apple YYYY-MM-DD biçimini belgeliyor ve DAILY için tarih gerekmediğini söylüyor. Hangi günü aldığınızı bilmek için yine de gönderin.
filter[version]Hayır1_0Apple’ın rapor türü için listelediği sürüm.
  1. Admin, Finance veya Sales rolüyle bir ekip API anahtarı oluşturun ve Issuer ID’sini, Key ID’sini ve .p8 dosyasını saklayın.
  2. Anahtarla bir JWT imzalayın (belirteç üretme). Çoğu istekte Apple 20 dakikadan uzun yaşayan belirteçleri reddeder, bu yüzden her toplu iş için yenisini üretin.
  3. Günü isteyin: GET https://api.appstoreconnect.apple.com/v1/salesReports?filter[frequency]=DAILY&filter[reportType]=SALES&filter[reportSubType]=SUMMARY&filter[vendorNumber]=85012345&filter[reportDate]=2026-11-09&filter[version]=1_0, Authorization: Bearer <token> ve Accept: application/a-gzip ile. HTTP istemciniz yapmıyorsa köşeli parantezleri URL kodlamasına çevirin.
  4. 200 yanıtının gövdesi gzip’tir (application/a-gzip). Açın — curl ile bir dosyaya kaydedip gunzip çalıştırın.
  5. Artık sekmeyle ayrılmış bir metniniz var: bir başlık satırı, ardından her ürün, ülke, fiyat ve işlem türü için bir satır. Sütunları konuma göre değil, başlık adına göre ayrıştırın.
  6. Günü saklayın. Apple günlük raporları yalnızca bir yıl tutar, bu yüzden yıldan yıla karşılaştırmak istediğiniz her şeyi kendi tarafınızda kaydetmeniz gerekir.
  7. İhtiyacınız olan her gün için tekrarlayın, hızınızı ayarlayarak: her yanıt, kalan saatlik isteklerinizi gösteren bir X-Rate-Limit başlığı taşır (istek sınırları).

Haftalık, aylık ve yıllık raporlar farklı bir sıklıkla aynı şekilde çalışır. Apple’ın dosya adı örnekleri haftalık bir raporu bir Pazar gününe tarihler, aylık ve yıllık dosyalara ise yalnızca ayı veya yılı verir; bu, hangi dönemi aldığınızı kontrol etmek için işe yarar. 30 günlük dosyayı toplamanın size istediğiniz gibi dilimleyebileceğiniz bir ay verdiğini, aylık bir dosyanın ise günleri vermediğini unutmayın.

Dosya biçimi ve önemli sütunlar

Summary Sales Report alan başvurusu her sütunu belgeler (düzenin 1_3 sürümünü anlatır; Apple zamanla sütun ekler, başlık adlarıyla eşleştirmenin bir nedeni de budur). Ülke bazlı satışlar için ihtiyacınız olanlar:

SütunNe içerirNe için kullanılır
Apple IdentifierUygulamanın veya uygulama içi satın almanın Apple ID’siAPI’deki ürünlerinizle eşleştirme
SKU / Parent IdentifierSKU’nuz; uygulama içi satın almalar için Parent Identifier uygulamanın SKU’sudurUygulama içi satın almaları uygulamalarının altında gruplama
Titleİndirmeler için uygulama adı, uygulama içi satın almalar için ürün kimliğiEtiketler
Product Type Identifierİşlem türü, örneğin 1F veya IAYİndirmeleri, satın almaları, güncellemeleri ve yeniden indirmeleri ayırma
UnitsToplanmış birimler; iadeler için negatifİndirmeleri ve satın almaları sayma
Developer ProceedsVergiler ve Apple’ın komisyonundan sonra birim başına aldığınız tutarGelir = Units × Developer Proceeds
Customer Price / Customer CurrencyMüşteriye birim başına faturalanan fiyat ve para birimiİnsanların gerçekten ödediği fiyatı kontrol etme
Country CodeSatın almanın yapıldığı App Store ülkesi veya bölgesinin iki harfli koduÜlke bazlı döküm
Currency of ProceedsDeveloper Proceeds tutarının para birimiÜlkeleri karşılaştırmadan önce dönüştürme
Subscription / PeriodYeni veya yenileme ve abonelik süresiYeni aboneleri yenilemelerden ayırma

Ürün türü tanımlayıcıları satırları sınıflandırır (tam liste): 1, 1F, 1T ve F1 ücretsiz veya ücretli uygulama indirmeleridir; 3 ve 3F yeniden indirmelerdir; 7, 7F, 7T ve F7 güncellemelerdir; IA1, IA9, IAY, FI1 ve -M karşılıkları uygulama içi satın almalar ve aboneliklerdir; IA3 geri yüklenen bir tüketilmeyen üründür.

  • Developer Proceeds birim başınadır. Satırları toplamadan önce Units ile çarpın.
  • İadelerin Units değeri negatif, Developer Proceeds değeri pozitiftir; bu yüzden Units × Developer Proceeds onları doğru biçimde düşer.
  • İndirmeleri saymadan önce güncellemeleri ve yeniden indirmeleri dışarıda bırakın — ücretsizdirler ve genellikle gerçek indirmelerden çok daha fazladırlar.
  • Aynı ürün ve ülke birkaç satırda görünebilir (farklı fiyatlar, cihazlar, promosyon kodları). Toplayın.
  • Günler UTC değil, Pasifik Saati ile geceyarısından geceyarısına işler.
  • Tutarlar yerel para birimlerindedir. Ülkeleri sıralamadan önce tek bir kur setiyle dönüştürün; ülkeye göre satışlar adil bir karşılaştırmayı adım adım anlatır.

Raporlar ne zaman hazır olur ve ne kadar kalır?

Apple’ın kullanılabilirlik sayfasından: günlük raporlar ertesi gün, haftalık raporlar Pazartesi günleri, aylık raporlar ay bittikten beş gün sonra ve yıllık raporlar yıl bittikten altı gün sonra hazırdır; genellikle Pasifik Saati ile sabah 8’e kadar. Günlük, haftalık ve aylık raporlar bir yıl, yıllık raporlar on yıl saklanır. Bir Summary Sales raporu yalnızca en az bir uygulama birimi satılmış bir dönem için bulunur, bu yüzden sessiz bir günün dosyası yoktur.

Sık görülen salesReports hataları

YanıtGenellikle ne anlama gelirNe yapmalı
400 PARAMETER_ERROR.REQUIREDZorunlu bir filtre eksik, örn. “The parameter 'filter[vendorNumber]' is required but was not provided”Dört zorunlu filtrenin hepsini gönderin.
400 (diğer)Apple’ın sunmadığı bir kombinasyon — rapor türüyle eşleşmeyen bir alt tür, sıklık veya sürümDeğerlerinizi yukarıdaki izin verilen değerler tablosuyla karşılaştırın.
401 NOT_AUTHORIZEDBelirteç hatalı biçimde, süresi dolmuş veya iptal edilmiş bir anahtarla imzalanmışYeni belirteç üretin; Key ID, Issuer ID ve .p8 dosyasının birbirine ait olduğunu kontrol edin.
403Anahtarın rolü satış raporlarını okuyamıyorAdmin, Finance veya Sales rolüne sahip bir anahtar kullanın.
404O tarih için rapor yok: henüz yayımlanmadı, o gün hiçbir şey satılmadı veya Apple’ın sakladığından eski“Veri yok” sayın, yakın günleri daha sonra yeniden deneyin.
429Bu anahtar için saatlik istek sınırına ulaşıldıGeri çekilin ve devam edin; geçmiş indirmeleri zamana yayın.
500 UNEXPECTED_ERRORApple’ın sunucusu başarısız oldu. Anahtarın ekibine ait olmayan bir satıcı numarası gönderdiğimizde net bir mesaj yerine bu döndüBir kez yeniden deneyin; sürerse her şeyden önce satıcı numarasını iki kez kontrol edin.

RepriceCat satıcı numaranızı nasıl kullanır?

RepriceCat fiyatları App Store Connect anahtarınızla değiştirir; satıcı numaranızla bu fiyatların ne yaptığını da görebilir. Ayarlar → Satış raporları bölümüne ekleyin. Anahtarınızın raporları okumak için Admin, Finance veya Sales rolüne ihtiyacı var — aynı anahtar fiyat da değiştiriyorsa Admin. Bundan sonra RepriceCat Apple’ın günlük SALES / SUMMARY raporlarını, her günü bir kez indirir ve yalnızca ürün ve ülke başına günlük toplamları tutar. Güncellemeler ve yeniden indirmeler dışarıda bırakılır.

  • Satışlar ekranı: ülke bazında birimler, indirmeler, satın almalar, gelir (bugünkü kurlarla USD cinsinden), pay ve eğilim; dünya haritası, günlük ve hafta içi günü grafikleri, uygulama ve ürüne göre filtrelerle.
  • Fiyatlandırma ipuçları, örneğin çok indirme ama az satın alma olan veya ortalamadan çok daha sık satın alan ülkeler.
  • Etkinlik’te her fiyat değişikliğinin etkisi: değişiklikten önce ve sonra, ürün ve ülke başına birimler ve gelir.
  • Deneyler: fiyatı birkaç ülkede değiştirin, geri kalanını karşılaştırma olarak tutun ve sonucu koruyun ya da geri alın (fiyat testi nasıl yapılır).

İndirme ve ayrıştırma betiğini kendiniz sürdürmek istemiyorsanız, RepriceCat ile API betiklerini karşılaştırın veya ücretsiz bir ayla başlayın.

Sık sorulanlar

App Store Connect’te satıcı numaramı nerede bulurum?

Ödemeler ve Finansal Raporlar’ı açın, üstten Raporlar’ı seçin ve numarayı sol üst köşede Yasal Kuruluş Adınızın altından okuyun. İndirdiğiniz herhangi bir satış raporunun dosya adında da görünür, örneğin S_D_80012345_20130919.

Satıcı numarası Team ID’m veya uygulamanın Apple ID’siyle aynı mı?

Hayır. Satıcı numarası, Ödemeler ve Finansal Raporlar’daki yasal kuruluşunuza bağlıdır. Team ID ve uygulama Apple ID’leri ayrı tanımlayıcılardır ve filter[vendorNumber] olarak çalışmaz.

Bir API anahtarının satış raporlarını indirmesi için hangi role ihtiyacı var?

Admin, Finance veya Sales. App Manager fiyat değiştirebilir ama Apple’ın Satışlar ve Eğilimler için listelediği roller arasında değildir; bu yüzden ikisini de yapan tek bir anahtar Admin gerektirir.

GET /v1/salesReports neden 404 döndürüyor?

O tarih için rapor yok: gün henüz yayımlanmadı, o gün hiçbir şey satılmadı veya tarih Apple’ın günlük raporları sakladığı bir yıldan eski. Bunu veri yok olarak değerlendirin ve yakın günleri daha sonra yeniden deneyin.

App Store satış raporlarını ne kadar geriye indirebilirim?

Günlük, haftalık ve aylık raporlar hazır olduktan sonra bir yıl, yıllık raporlar on yıl saklanır. Daha uzun günlük geçmişe ihtiyacınız varsa dosyaları kendiniz kaydedin.

Günlük satış raporu için hangi sürümü kullanmalıyım?

Apple’ın uç nokta başvurusu SALES ve SUMMARY için 1_0 sürümünü listeler. Apple düzen sürümleri arasında sütun eklediği için dosyayı konuma göre değil, sütun adlarına göre ayrıştırın.

Deneyin

Her ülkeyi tek bir temel fiyattan yeniden fiyatlandırın

Kademeler, fiyat noktasına yuvarlama, tek bir gözden geçirme tablosu, tek bir onay — App Store Connect API üzerinden. İlk ay ücretsiz, sonrasında uygulama başına aylık 1 $.