Skip to main content

Amplitude

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable Self-Managed EnterpriseAvailable PyAirbyte
Support Level
Airbyte
Connector Version
0.7.31 (last updated 7 days ago)
Definition ID
fa9f58c6-2d03-4237-aaa4-07d75e0c1396

This page guides you through setting up the Amplitude source connector. This connector syncs data from several Amplitude Analytics APIs, including the Dashboard REST API, Export API, Chart Annotations API, and Behavioral Cohorts API.

Prerequisites​

To set up the Amplitude source connector, you need an Amplitude API key and secret key. To find these credentials:

  1. In the Amplitude Analytics web app, select Organization Settings in the upper navigation.
  2. Select Projects, then select your target project.
  3. Copy the API Key and Secret Key.

For more information, see Manage your API keys and secret keys in the Amplitude documentation.

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 your Amplitude API key and secret key.
  6. For Replication Start Date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. Data added on and after this date is replicated. If this field is blank, Airbyte replicates all data.
  7. Optionally, configure the following fields:
    • Data Region: Select EU Residency Server if your Amplitude project is hosted in the EU data center. Defaults to Standard Server.
    • Request Time Range: The time interval in hours for each Events stream request. Reduce this value if event exports time out due to large data volumes. Defaults to 24 hours. See Amplitude's Export API considerations for details.
    • Active Users Group by Country: When enabled, the Active Users stream groups results by country. Disable this if you encounter errors fetching the Active Users stream. Enabled by default.
  8. 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, create an issue.

Supported sync modes​

The Amplitude source connector supports the following sync modes:

  • Full Refresh
  • Incremental

Performance considerations​

The connector automatically handles Amplitude's API rate limits. The Dashboard REST API enforces cost-based rate limits with a budget of 108,000 cost per hour and 1,000 cost per 5-minute burst window, plus a maximum of 5 concurrent requests. The connector tracks per-request costs and throttles automatically to stay within these limits.

The Export API (used by the Events stream) doesn't have documented rate limits, but large exports can time out. If you experience timeouts, reduce the Request Time Range in the connector configuration.

If you encounter rate limit issues that are not automatically retried, create an issue.

Reference​

Config fields reference

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

Changelog​

Expand to review
VersionDatePull RequestSubject
0.7.312026-04-2872688Update dependencies
0.7.302026-03-3175406Upgrade CDK to v7.14.0 and use weight-based rate limiting for Dashboard REST API streams
0.7.292026-03-0370841Add HTTPAPIBudget and concurrency_level
0.7.282026-01-2071912Update dependencies
0.7.272026-01-1471434Update dependencies
0.7.262025-12-1870795Update dependencies
0.7.252025-11-2569522Update dependencies
0.7.242025-10-2968881Update dependencies
0.7.232025-10-2168361Update dependencies
0.7.222025-10-1467986Update dependencies
0.7.212025-10-0767159Update dependencies
0.7.202025-09-3062537Update dependencies
0.7.192025-09-1065994Update to CDK v7
0.7.182025-06-2862135Update dependencies
0.7.172025-06-2161897Update dependencies
0.7.162025-06-1560600Update dependencies
0.7.152025-05-2360887Fix cohorts extractor field_path
0.7.142025-05-1059808Update dependencies
0.7.132025-05-0359369Update dependencies
0.7.122025-04-2658709Update dependencies
0.7.112025-04-1958264Update dependencies
0.7.102025-04-1257605Update dependencies
0.7.92025-04-0557173Update dependencies
0.7.82025-03-2956591Update dependencies
0.7.72025-03-2256132Update dependencies
0.7.62025-03-0855359Update dependencies
0.7.52025-03-0154883Update dependencies
0.7.42025-02-2254247Update dependencies
0.7.32025-02-1552939Update dependencies
0.7.22025-02-1353655Fix CDK breaking change
0.7.12025-01-2552213Update dependencies
0.7.02025-01-2452144Promoting release candidate 0.7.0-rc.1 to a main version.
0.7.0-rc.12025-01-1751601Migrates to manifest-only
0.6.192025-01-1851723Update dependencies
0.6.182025-01-1151288Update dependencies
0.6.172025-01-0450906Update dependencies
0.6.162024-12-2850486Update dependencies
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?