Visitor Activity Object

Use activities resources to learn how visitors and prospects have interacted with your website. Examples of activities include:

  • Viewing and clicking your website
  • Submitting a form
  • Clicking a social media post

Learn more about visitor activities in Salesforce Help.

The API to access the Visitor Activity object follows the conventions described in Version 5 Overview.

OperationHTTP VerbURL FormatAbility Requirements
QueryGEThttps://pi.pardot.com/api/v5/objects/visitor-activities?<params>Prospect > Visitors > View ability
ReadGEThttps://pi.pardot.com/api/v5/objects/visitor-activities/<id>?<params>Prospect > Visitors > View ability

Read-Only Fields

FieldTypeDescription
campaignIdIntegerPardot ID for the associated campaign.
campaignCampaignObject representing the campaign related to this object. See documentation for Campaign for fields.
createdAtDateTimeTime that visitor activity occurred; Time is reported in API user's preferred timezone.
customRedirectIdIntegerPardot ID of the custom redirect associated with this visitor activity Note: Appears only if this visitor activity has a custom redirect associated with it.
customRedirectCustom RedirectObject representing the custom redirect related to this object. See documentation for Custom Redirect for fields.
detailsStringDetails about this visitor activity such as the name of the object associated with this activity, the search phrase used in a site search query, etc.
emailIdIntegerPardot ID of the email associated with this visitor activity. Appears only if this visitor activity has an email associated with it.
emailTemplateIdIntegerPardot ID of the email template associated with this visitor activity. Appears only if this visitor activity has an email associated with it.
emailTemplateEmail TemplateObject representing the email template related to this object. See documentation for Email Template for fields.
emailEmailObject representing the email related to this object. See documentation for Email for fields.
fileIdIntegerPardot ID of the file associated with this visitor activity. Appears only if this visitor activity has a file associated with it.
fileFileObject representing the file related to this object. See documentation for File for fields.
formHandlerIdIntegerPardot ID of the form handler associated with this visitor activity. Appears only if this visitor activity has a form handler associated with it.
formHandlerForm HandlerObject representing the form handler related to this object. See documentation for Form Handler for fields.
formIdIntegerPardot ID of the form associated with this visitor activity. Appears only if this visitor activity has a form associated with it.
formFormObject representing the form related to this object. See documentation for Form for fields.
idIntegerPardot ID for this visitor activity.
landingPageIdIntegerPardot ID of the landing page associated with this visitor activity. Appears only if this visitor activity has a landing page associated with it.
landingPageLanding PageObject representing the landing page related to this object. See documentation for Landing Page for fields.
listEmailIdIntegerPardot ID of the list email associated with this visitor activity. Appears only if this visitor activity has an email associated with it.
listEmailList EmailObject representing the list email related to this object. See documentation for List Email for fields.
multivariateTestVariationIdIntegerPardot ID of the multivariate test variation associated with this visitor activity. Appears only if this visitor activity has a multivariate test variation associated with it.
opportunityIdIntegerPardot ID for the associated opportunity.
opportunityOpportunityObject representing the opportunity related to this object. See documentation for Opportunity for fields.
paidSearchAdIdIntegerPardot ID of the paid search ad associated with this visitor activity. Appears only if this visitor activity has a paid search ad associated with it.
prospectIdIntegerPardot ID for the associated prospect.
prospectProspectObject representing the prospect related to this object. See documentation for Prospect for fields.
siteSearchQueryIdIntegerPardot ID of the site search query associated with this visitor activity. Appears only if this visitor activity has a site search query associated with it.
typeNameStringVisitor activity's type name.
typeIntegerVisitor activity's type number.
updatedAtDateTimeTime that visitor activity update occurred; Time is reported in API user's preferred timezone.
visitIdIntegerPardot ID for the associated visit.
visitVisitObject representing the visit related to this object. See documentation for Visit for fields.
visitorIdIntegerPardot ID for the associated visitor.
visitorIdIntegerPardot ID for the associated visitor.
visitorPageViewIdIntegerPardot ID for the associated visitor page view.
visitorPageViewVisitor Page ViewObject representing the visitor page view related to this object. See documentation for Visitor Page View for fields.
visitorVisitorObject representing the visitor related to this object. See documentation for Visitor for fields.

Visitor Activity Types

Visitor Activities may have the following values for type

  • 1 - Click
  • 2 - View
  • 3 - Error
  • 4 - Success
  • 5 - Session (Omitted from Synchronous and Export endpoints)
  • 6 - Sent
  • 7 - Search
  • 8 - New Opportunity
  • 9 - Opportunity Won
  • 10 - Opportunity Lost
  • 11 - Open
  • 12 - Unsubscribe Page
  • 13 - Bounced
  • 14 - Spam Complaint
  • 15 - Email Preference Page
  • 16 - Resubscribed
  • 17 - Click (Third Party)
  • 18 - Opportunity Reopened
  • 19 - Opportunity Linked
  • 20 - Visit
  • 21 - Custom URL click
  • 22 - Olark Chat
  • 23 - Invited to Webinar
  • 24 - Attended Webinar
  • 25 - Registered for Webinar
  • 26 - Social Post Click
  • 27 - Video View
  • 28 - Event Registered
  • 29 - Event Checked In
  • 30 - Video Conversion
  • 31 - UserVoice Suggestion
  • 32 - UserVoice Comment
  • 33 - UserVoice Ticket
  • 34 - Video Watched (≥ 75% watched)
  • 35 - Indirect Unsubscribe Open
  • 36 - Indirect Bounce
  • 37 - Indirect Resubscribed
  • 38 - Opportunity Unlinked
  • Other - Unknown

Retrieve a single visitor activity following the conventions described in the Version 5 Overview.

Example request:

Example response:

Retrieving a collection of visitor activities follows the conventions described in Version 5 Overview.

Sortable Fields

When executing a query, the following fields can be specified in the orderBy parameter. See the conventions for query described in the Version 5 Overview.

  • id
  • createdAt
  • updatedAt

Example request:

Example response:

Filtering Results

When executing a query, the following parameters can be used to filter the returned results. These parameters can be specified in the request along with any shared parameters defined in Version 5 Overview. When specifying more than one parameter, all parameters must match the record in order for it to be returned in the results.

ParameterDescription
createdAtAfterOrEqualToReturns any visit where CreatedAt is after or equal to the given datetime value.
createdAtAfterReturns any visit where CreatedAt is after the given datetime value, non-inclusive.
createdAtBeforeOrEqualToReturns any visit where CreatedAt is before or equal to the given datetime value.
createdAtBeforeReturns any visit where CreatedAt is before the given datetime value, non-inclusive.
createdAtReturns any visit where CreatedAt is equal to the given datetime value.
idGreaterThanOrEqualToReturns any visit where ID is greater than or equal to the specified value.
idGreaterThanReturns any visit where ID is greater than the specified value, non-inclusive.
idLessThanOrEqualToReturns any visit where ID is less than or equal to the specified value.
idLessThanReturns any visit where ID is less than the specified value, non-inclusive.
idReturns any visit where ID is equal to the given integer value.
prospectIdGreaterThanOrEqualToReturns any visit where ProspectId is greater than or equal to the specified value.
prospectIdGreaterThanReturns any visit where ProspectId is greater than the specified value, non-inclusive.
prospectIdLessThanOrEqualToReturns any visit where ProspectId is less than or equal to the specified value.
prospectIdLessThanReturns any visit where ProspectId is less than the specified value, non-inclusive.
prospectIdReturns any visit where ProspectId is equal to the given integer value.
typeReturns any visit where type is equal to the given value.
updatedAtAfterOrEqualToReturns any visit where UpdatedAt is after or equal to the given datetime value.
updatedAtAfterReturns any visit where UpdatedAt is after the given datetime value, non-inclusive.
updatedAtBeforeOrEqualToReturns any visit where UpdatedAt is before or equal to the given datetime value.
updatedAtBeforeReturns any visit where UpdatedAt is before the given datetime value, non-inclusive.
updatedAtReturns any visit where UpdatedAt is equal to the given datetime value.
visitorIdGreaterThanOrEqualToReturns any visit where VisitorId is greater than or equal to the specified value.
visitorIdGreaterThanReturns any visit where VisitorId is greater than the specified value, non-inclusive.
visitorIdLessThanOrEqualToReturns any visit where VisitorId is less than or equal to the specified value.
visitorIdLessThanReturns any visit where VisitorId is less than the specified value, non-inclusive.
visitorIdReturns any visit where VisitorId is equal to the given integer value.

Example request:

Example response: