Skip to main content

Pardot API Client

Project description

A Python client for the Pardot API.

It provides object notation for interacting with resources on the API in clean and simple idiomatic statements like:

>>> client.prospect.read('someone@example.com')
>>> client.prospect.update('someone@example.com', first_name='John')

Features

  • Supports Python 2 and 3
  • Supports API version 3
  • Supports all API entities: Account, Campaign, Custom Field, Custom Redirect, Dynamic Content, Email, Email Clicks, Form, Identified Company, Lifecycle History, Lifecycle Stage, List, List Membership, Opportunity, Profile, Profile Criteria, Prospect, Prospect Account, Tag, Tag Object, User, Visit, Visitor, Visitor Activity, Visitor Page View, Visitor Referrer
  • Supports most API operations: query, assign, unassign, create, read, update, upsert, delete
  • Supports un-setting of field values
  • Handles API session timeouts implicitly
  • Transparent API error feedback
  • Optional request retries with incremental back-off

Planned features

  • Support for API version 4
  • Support for API batch operations: batchCreate, batchUpdate, batchUpsert
  • Supports result set manipulation, eg specifying fields, limit, offset, sort_by, sort_order
  • Implicit results pagination
  • Implicit chunking for batch operationss

Installation

$ pip install pardot-api-client

Usage

  1. Obtain API authentication credentials from Pardot by following instructions at http://developer.pardot.com/#authentication - you’ll need the following: email, password, user_key

  2. Review the supported Pardot API documentation at http://developer.pardot.com/#official-pardot-api-documentation

  3. Use the Python API client to interact with the API:

    >>> from pardot.client import APIClient
    >>> client = APIClient(
    ...     'pardot-email',
    ...     'pardot-password',
    ...     'pardot-user_key')
    ...
    >>> # read
    >>> r = client.prospect.read('someone@example.com')
    >>> print(r)
    >>> # update
    >>> r = client.prospect.update('someone@example.com', first_name='John')
    >>> print(r)
    >>> # query
    >>> for r in client.prospect.query(new=True):
    ...    print(r)
    ...
    

Arguments vs keyword arguments

To keep the client’s API simple it makes educated guesses about the identifiers passed in resource operation calls.

To make this work all required parameters (except user_key and api_key, which are automatically added) must be passed as positional arguments and any optional parameters passed as keyword arguments.

For instance, the API documentation states that “assign” operations on “prospect” resources may use either “email” or “id” as identifiers and must supply one of the following parameters: “user_email” or “user_id” or “group_id”. Any of the forms below could be used to make this call from the client:

>>> # identify by email
>>> client.prospect.update('someone@example.com', user_email='someone-else@example.com')
>>> client.prospect.update('someone@example.com', user_id=2544897)
>>> client.prospect.update('someone@example.com', group_id=5499876)
>>> # identify by id
>>> client.prospect.update(7142577, user_email='someone-else@example.com')
>>> client.prospect.update(7142577, user_id=2544897)
>>> client.prospect.update(7142577, group_id=5499876)

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pardot-api-client, version 0.0.1
Filename, size File type Python version Upload date Hashes
Filename, size pardot_api_client-0.0.1-py2-none-any.whl (7.9 kB) File type Wheel Python version 2.7 Upload date Hashes View hashes
Filename, size pardot-api-client-0.0.1.tar.gz (6.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page