Skip to main content

Appstore

Sync overview

This source can sync data for the Appstore API. It supports only Incremental syncs. The Appstore API is available for many types of services. Currently, this API supports syncing Sales and Trends reports. If you'd like to sync data from other endpoints, please create an issue on Github.

This Source Connector is based on a Singer Tap.

Output schema

This Source is capable of syncing the following "Sales and Trends" Streams:

Note that depending on the credentials you enter, you may only be able to sync some of these reports. For example, if your app does not offer subscriptions, then it is not possible to sync subscription related reports.

Data type mapping

Integration TypeAirbyte TypeNotes
stringstring
int, float, numbernumber
datedate
datetimedatetime
arrayarray
objectobject

Features

FeatureSupported?(Yes/No)Notes
Full Refresh Syncno
Incremental Syncyes
NamespacesNo

Performance considerations

The connector is restricted by normal Appstore requests limitation.

The Appstore connector should not run into Appstore API limitations under normal usage. Please create an issue if you see any rate limit issues that are not automatically retried successfully.

One issue that can happen is the API not having the data available for the period requested, either because you're trying to request data older than 365 days or the today's and yesterday's data was not yet made available to be requested.

Getting started

Requirements

  • Key ID
  • Private Key The contents of the private API key file, which is in the P8 format and should start with -----BEGIN PRIVATE KEY----- and end with -----END PRIVATE KEY-----.
  • Issuer ID
  • Vendor ID Go to "Sales and Trends", then choose "Reports" from the drop-down menu in the top left. On the next screen, there'll be a drop-down menu for "Vendor". Your name and ID will be shown there. Use the numeric Vendor ID.
  • Start Date (The date that will be used in the first sync. Apple only allows to go back 365 days from today.) Example: 2020-11-16T00:00:00Z

Setup guide

Generate/Find all requirements using this external article.

Changelog

VersionDatePull RequestSubject
0.2.62021-12-238434Update fields in source-connectors specifications
0.2.52021-12-097757Migrate to the CDK
0.2.42021-07-064539Add AIRBYTE_ENTRYPOINT for Kubernetes support