inboxtracker.intelliseeds

class inboxtracker.intelliseeds.Intelliseeds(base_uri, api_key, transport_class=<class 'inboxtracker.base.RequestsTransport'>)
create_intelliseed_filter(**kwargs)

Places a new IntelliSeed filter set under the given account

Parameters

  • name (str) – Name of the filter set

  • listType (str) –

    Privacy level of list.

    Accepts: PUBLIC, EXCLUSIVE, PRIVATE

  • simulatedEngagementOption (str) –

    Engagement level of the IntelliSeeds to include in the list.

    Accepts: ALL, ENGAGING, NON_ENGAGING

  • percentOfList (int) – Percent of the list to include. Integer from 0-100.

  • regions – List of strings. The regions to include. For options, See Current Regions

  • childAccountId (int) – The child account to place filter

Returns

A dict object containing the details of the crated IntelliSeed list, such as the name and ID.

delete_intelliseed_filter(filterSetId, **kwargs)

Removes the IntelliSeed filter set using the filter set id provided

Parameters

  • filterSetId (int) – The id of the IntelliSeed filter set

  • childAccountId (int) – The child account to narrow results

Returns

A dict object containing the details of the deleted IntelliSeed list, such as the name and ID.

get_filter_sets(**kwargs)

Get the list of IntelliSeed filter sets configured for an account

Parameters

childAccountId (int) – The child account to narrow results

Returns

A list object of ‘dict’ containing details of a filter set, such as the name of the IntelliSeed list.

get_intelliseeds(**kwargs)

Get an updated IntelliSeed list

Parameters

  • childAccountId (int) – The child account to narrow results

  • type (str) –

    The type of IntelliSeed list to pull.

    Accepts: PUBLIC, PRIVATE, EXCLUSIVE. Default is PRIVATE

  • percentOfList (int) – The integer percent, 1-100, of the IntelliSeed list to pull. Default is 100

  • simulatedEngagementOption (str) –

    Which engagement types of IntelliSeed accounts to include.

    Accepts: ALL, ENGAGING, and NON_ENGAGING. Default is ALL

  • regions –

    List of strings. The regions to include IntelliSeed accounts from. For options, See Current Regions

    Default is all regions.

Returns

A list object of dict containing details of an IntelliSeed address, including email address, location, and ISP.

get_intelliseeds_filtered(filterSetId, **kwargs)

Gets the latest IntelliSeed list associated with the filter set id provided

Parameters

  • filterSetId (int) – The id of the IntelliSeed filter set

  • childAccountId (int) – The child account to narrow results

Returns

A list object of ‘dict’ containing details of the specified filter set, such as the name and ID of the IntelliSeed list.

get_last_update(**kwargs)

Get the time of the last update to IntelliSeed List

Parameters

childAccountId (int) – The child account to narrow results

Returns

A list object of ‘dict’ containing the account ID and last update date of the IntelliSeed list.