competitivetracker.domain_info

class competitivetracker.domain_info.Domain_Info(base_uri, api_key, transport_class=<class 'competitivetracker.base.RequestsTransport'>)
get_brand_volume_and_esps(domains, **kwargs)

Returns the average sending volume of a list of brands over a user defined time period (average can be per month or per day) and every ESPs from domains associated with the brand.

Parameters

  • domains – List of strings. Domains to find info for (multiple allowed)

  • endDate (str) –

    Endpoint of the requested date range concerning volume data with a format of yyyy-mm-dd. This date is exclusive: data concerning the given date will not be included in volume average.

    Defaults to current date

  • precision (str) –

    Precision of the average (i.e. per month or per day).

    Accepts: days or months.

    Defaults to days.

  • timePeriod (int) –

    How many days or months back you would like sending volume data for. This is for a time period backwards.

    Defaults to 30.

  • mustMatchTLD (bool) – Include only domains that match the top level domain (TLD) of any domain requested

Returns

A dict object where each element is a list of dict containing average sending volumes for brands

get_domain_info(**kwargs)

Determines the sending list size, recent ESPs, and personalization information for domains.

Parameters

domain – List of strings. Domain to find info for (multiple allowed)

Returns

A list of object dict containing sending list and ESP details for a domain