Get Export

GET https://amplitude.com/api/2/export?start=&end=

Considerations

The specified date range is the time of when the event data was uploaded to Amplitude servers (see serveruploadtime). The Export API returns events timestamped in UTC. Data is available to export at a minimum within 2 hours of when our servers received it. For example, data sent between 8-9PM begins loading at 9PM and is available via the Export API at 11PM. Note that there is no delay in platform reporting. The delay is only for data you wish to export.
Export API is not supported for a cross-project view because the view doesn’t own any data. To export all the data in the view, you would need to call the Export API on the underlying projects that actually ingested the data.
Size limit is 4GB. If the size exceeds 4GB, you will receive a 400 response. In this case, we recommend that you chose a smaller time range to export the data.
In case that an hour's worth of data exceeds 4GB, we recommend that the customers use the S3 export solution.
To export a whole day, Use T00 to T23. The maximum time range you can query at once is 365 days.

Response

The response is a zipped archive of JSON files, with potentially multiple files per hour. Note that events prior to 2014-11-12 will be grouped by day instead of by the hour. If you request data for a time range during which no data has been collected for the project, then you will receive a 404 response from our server.

Response Schema

{
 "server_received_time": UTC ISO-8601 formatted timestamp,
 "app": int,
 "device_carrier": string,
 "$schema":int,
 "city": string,
 "user_id": string,
 "uuid": UUID,
 "event_time": UTC ISO-8601 formatted timestamp,
 "platform": string,
 "os_version": string,
 "amplitude_id": long,
 "processed_time": UTC ISO-8601 formatted timestamp, 
 "user_creation_time": UTC ISO-8601 formatted timestamp,
 "version_name": string,
 "ip_address": string,
 "paying": boolean,
 "dma": string,
 "group_properties": dict,
 "user_properties": dict,
 "client_upload_time": UTC ISO-8601 formatted timestamp,
 "$insert_id": string,
 "event_type": string,
 "library":string,
 "amplitude_attribution_ids": string,
 "device_type": string,
 "device_manufacturer": string,
 "start_version": string,
 "location_lng": float,
 "server_upload_time": UTC ISO-8601 formatted timestamp,
 "event_id": int,
 "location_lat": float,
 "os_name": string,
 "amplitude_event_type": string,
 "device_brand": string,
 "groups": dict,
 "event_properties": dict,
 "data": dict,
 "device_id": string,
 "language": string,
 "device_model": string,
 "country": string,
 "region": string,
 "is_attribution_event": bool,
 "adid": string,
 "session_id": long,
 "device_family": string,
 "sample_rate": null,
 "idfa": string,
 "client_event_time": UTC ISO-8601 formatted timestamp,
}

Request Params

Key	Datatype	Required	Description
`start`	null		Required. First hour included in data series, formatted YYYYMMDDTHH (e.g. '20150201T05').
`end`	null		Required. Last hour included in data series, formatted YYYYMMDDTHH (e.g. '20150203T20').

RESPONSES

status: OK

&quot;\u003creturns zip file\u003e&quot;