Bulk Activity Extract
The Bulk Activity Extract set of REST APIs provides a programmatic interface for retrieving large amounts of activity data out of Marketo. 聽For cases that do not require low latency, and must transfer significant volumes of activity data out of Marketo, such as CRM-integration, ETL, data warehousing, and data archiving.
Permissions
The Bulk Activity Extract APIs require that the API user have the 鈥淩ead-Only Activity鈥 or 鈥淩ead-Write Activity鈥 permissions.
Filters
Filter Type
Data Type
Required
Notes
createdAt
Date Range
Yes
Accepts a JSON object with the members
startAt
and endAt
. startAt
accepts a datetime representing the low-watermark, and endAt
accepts a datetime representing the high-watermark. The range must be 31 days or fewer. Jobs with this filter type return all accessible records that were created within the date range. Datetimes should be in an ISO-8601 format, without milliseconds.activityTypeIds
Array[Integer]
No
Accepts a JSON object with one member,
activityTypeIds
. The value must be an array of integers, corresponding to the desired activity types. The 鈥淒elete Lead鈥 activity is not supported (use the endpoint instead). Retrieve activity type ids using the the.Array[Integer]
No
Accepts a JSON object with one member,
primaryAttributeValueIds
. The value is an array of ids that specify the primary attributes to filter on. A maximum of 50 ids may be specified. The ids are the unique identifier for either a lead field or an asset, and can be retrieved by calling the appropriate REST API endpoint. For example, to filter on a specific Form for the 鈥淔ill Out Form鈥 activity, pass the Form name to the endpoint to