Skip to main content

Amplitude

Availability:
Available Airbyte CloudAvailable Airbyte OSSAvailable PyAirbyte
Support Level:
Airbyte Connector
Connector Version:
0.6.15(Last updated 6 hours ago)
CDK Version:
4.6.2
Sync Success Rate:
Usage Rate:

This page guides you through setting up the Amplitude source connector to sync data for the Amplitude API.

Prerequisite​

To set up the Amplitude source connector, you'll need your Amplitude API Key and Secret Key.

Set up the Amplitude source connector​

  1. Log into your Airbyte Cloud or Airbyte Open Source account.
  2. Click Sources and then click + New source.
  3. On the Set up the source page, select Amplitude from the Source type dropdown.
  4. Enter a name for your source.
  5. For API Key and Secret Key, enter the Amplitude API key and secret key.
  6. For Replication Start Date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. The data added on and after this date will be replicated. If this field is blank, Airbyte will replicate all data.
  7. Click Set up source.

Supported Streams​

The Amplitude source connector supports the following streams:

If there are more endpoints you'd like Airbyte to support, please create an issue.

Supported sync modes​

The Amplitude source connector supports the following sync modes:

  • Full Refresh
  • Incremental

Connector-specific features​

There are two data region servers supported by Airbyte:

  • Standard Server
  • EU Residency Server

The Standard Server will be the default option until you change it in the Optional fields.

Performance considerations​

The Amplitude connector ideally should gracefully handle Amplitude API limitations under normal usage. Create an issue if you see any rate limit issues that are not automatically retried successfully.

Reference​

Config fields reference

Field
Type
Property name
string
api_key
string
secret_key
string
start_date
string
data_region
integer
request_time_range
boolean
active_users_group_by_country

Changelog​

Expand to review
VersionDatePull RequestSubject
0.6.152024-12-2150150Update dependencies
0.6.142024-12-1449017Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.6.132024-10-2947097Update dependencies
0.6.122024-10-1246771Update dependencies
0.6.112024-10-1146736Added possibility to toggle groupping by Country for Active Users stream
0.6.102024-10-0546489Update dependencies
0.6.92024-09-2846121Update dependencies
0.6.82024-09-2145732Update dependencies
0.6.72024-09-1445501Update dependencies
0.6.62024-09-0745318Update dependencies
0.6.52024-08-3145047Update dependencies
0.6.42024-08-2444709Update dependencies
0.6.32024-08-1744250Update dependencies
0.6.22024-08-1243876Update dependencies
0.6.12024-08-1043473Update dependencies
0.6.02024-08-0843400Add Events List Stream
0.5.12024-08-0343267Update dependencies
0.5.02024-08-0142565Migrate to CDK v4.0.2
0.4.22024-07-2742618Update dependencies
0.4.12024-07-2042302Update dependencies
0.4.02024-07-1742074Migrate to CDK v1.8.0
0.3.182024-07-1341767Update dependencies
0.3.172024-07-1041537Update dependencies
0.3.162024-07-0941097Update dependencies
0.3.152024-07-0640982Update dependencies
0.3.142024-06-2540407Update dependencies
0.3.132024-06-2240108Update dependencies
0.3.122024-06-0639103Use CheckpointMixin for state management
0.3.112024-06-0438988[autopull] Upgrade base image to v1.2.1
0.3.102024-04-1936631Updating to 0.80.0 CDK
0.3.92024-04-1236631schema descriptions
0.3.82024-03-1235987Unpin CDK version
0.3.72024-02-1235162Manage dependencies with Poetry.
0.3.62023-10-2331702Base image migration: remove Dockerfile and use the python-connector-base image
0.3.52023-09-2830846Add support of multiple cursor date formats
0.3.42023-09-2830831Add user friendly error description on 403 error
0.3.32023-09-2130652Update spec: declare start_date type as date-time
0.3.22023-09-1830525Fix KeyError while getting data_region from config
0.3.12023-09-1530471Fix Event stream: Use start_time instead of cursor in the case of more recent
0.3.02023-09-1330378Switch to latest CDK version
0.2.42023-05-0525842added missing attrs in events schema, enabled default availability strategy
0.2.32023-04-2025317Refactor Events Stream, use pre-YAML version based on Python CDK
0.2.22023-04-1925315Refactor to only fetch date_time_fields once per request
0.2.12023-02-0325281Reduce request_time_range to 4 hours
0.2.02023-02-0322362Migrate to YAML
0.1.242023-03-2821022Enable event stream time interval selection
0.1.232023-03-0223087Specified date formatting in specification
0.1.222023-02-1723192Skip the stream if start_date is specified in the future.
0.1.212023-02-0121888Set AvailabilityStrategy for streams explicitly to None
0.1.202023-01-2721957Handle null values and empty strings in date-time fields
0.1.192022-12-0919727Remove data_region as required
0.1.182022-12-0819727Add parameter to select region
0.1.172022-10-3118684Add empty series validation for AverageSessionLength stream
0.1.162022-10-1117854Add empty series validation for ActtiveUsers steam
0.1.152022-10-0317320Add validation start_date filed if it's in the future
0.1.142022-09-2817326Migrate to per-stream states.
0.1.132022-08-3116185Re-release on new airbyte_cdk==0.1.81
0.1.122022-08-1115506Changed slice day window to 1, instead of 3 for Events stream
0.1.112022-07-2114924Remove additionalProperties field from spec
0.1.102022-06-1613846Try-catch the BadZipFile error
0.1.92022-06-1013638Fixed an infinite loop when fetching Amplitude data
0.1.82022-06-0113373Fixed the issue when JSON Validator produces errors on date-time check
0.1.72022-05-2113074Removed time offset for Events stream, which caused a lot of duplicated records
0.1.62022-04-3012500Improve input configuration copy
0.1.52022-04-2812430Added HTTP error descriptions and fixed Events stream fail caused by 404 HTTP Error
0.1.42021-12-238434Update fields in source-connectors specifications
0.1.32021-10-126375Log Transient 404 Error in Events stream
0.1.22021-09-216353Correct output schemas on cohorts, events, active_users, and average_session_lengths streams
0.1.12021-06-093973Add AIRBYTE_ENTRYPOINT for kubernetes support
0.1.02021-06-083664New Source: Amplitude
0.1.02021-06-083664New Source: Amplitude
Was this page helpful?