FAQs
How do I get started?

If you have already been provided API access you can start using it immediatly, if you have not yet received API access please reach out to help@myactiv8plus.com and we would be happy to assist you in aquiring API access.

What are your Rate Limits?

Currently, our Rate Limits are set to 500 requests within 5-minute sliding windows.

Is CORS supported?

Currently, we do not provide support for CORS. Instead, we require that clients use JSONP to make GET requests.

Do you provide an SLA?

Currently, we do not provide an SLA.

Authentication
Getting Started

All Activ8 Plus API endpoints require authentication through the usage of an access_token. To retrieve an API access_token, please contact help@myactiv8plus.com.

Using The Token

All requests to the Activ8 Plus API must be made using HTTPS, with the access_token provided. Input your personal API access_token as a URL parameter after the enpoint URL.

https://api.myactiv8plus.com/v1/campaigns?access_token=ACCESS_TOKEN

/campaigns
GET /campaigns

Retrieve a list of your campaigns.

https://api.myactiv8plus.com/v1/campaigns

Query Parameters

Parameter Required Type Default Description
access_token Yes string   Activ8 Plus API Access Token

Response

{ "campaign": "ztYaERok", "campaign_name": "Campaign Demo" }, { "campaign": "kElcOzla", "campaign_name": "Another Campaign Demo" }

/media
GET /analytics/media/:media_id

Get information about a media object.

https://api.myactiv8plus.com/v1/analytics/media/:media_id

Query Parameters

Parameter Required Type Default Description
access_token Yes string   Activ8 Plus API Access Token
media_id Yes interger   Media id for object

Response

{ "campaign": "ztYaERok", "campaign_name": "Campaign Demo" }, { "campaign": "kElcOzla", "campaign_name": "Another Campaign Demo" }

/uploads
GET /analytics/uploads/:campaign

Retrieve a summary of activity over a given date range.

https://api.myactiv8plus.com/v1/analytics/uploads/:campaign

Query Parameters

Parameter Required Type Default Description
access_token Yes string   Activ8 Plus API Access Token
start_date No string 30 days ago ISO-8601 formatted date for beginning of date range (see Timeframe)
end_date No string Current date ISO-8601 formatted date for end of date range (see Timeframe)
timezone No string UTC UTC Offset for date range e.g. “-7:00” (see Timezone)

Response

{ "result": 133 }

/pageviews
GET /analytics/pageviews/:campaign

Retrieve a summary of activity over a given date range.

https://api.myactiv8plus.com/v1/analytics/pageviews/:campaign

Query Parameters

Parameter Required Type Default Description
access_token Yes string   Activ8 Plus API Access Token
start_date No string 30 days ago ISO-8601 formatted date for beginning of date range (see Timeframe)
end_date No string Current date ISO-8601 formatted date for end of date range (see Timeframe)
timezone No string UTC UTC Offset for date range e.g. “-7:00” (see Timezone)

Response

{ "result": 133 }

/shares
GET /analytics/shares/:campaign

Retrieve a summary of activity over a given date range.

https://api.myactiv8plus.com/v1/analytics/shares/:campaign

Query Parameters

Parameter Required Type Default Description
access_token Yes string   Activ8 Plus API Access Token
start_date No string 30 days ago ISO-8601 formatted date for beginning of date range
end_date No string Current date ISO-8601 formatted date for end of date range
timezone No string UTC UTC Offset for date range e.g. “-7:00”

Response

{ "result": 1 }

/clicks
GET /analytics/clicks/:campaign

Retrieve a summary of activity over a given date range.

https://api.myactiv8plus.com/v1/analytics/clicks/:campaign

Query Parameters

Parameter Required Type Default Description
access_token Yes string   Activ8 Plus API Access Token
start_date No string 30 days ago ISO-8601 formatted date for beginning of date range (see Timeframe)
end_date No string Current date ISO-8601 formatted date for end of date range (see Timeframe)
timezone No string UTC UTC Offset for date range e.g. “-7:00” (see Timezone)

Response

{ "result": 133 }

/data-collection
GET /data-collection/:campaign

Retrieve a summary of activity over a given date range.

https://api.myactiv8plus.com/v1/data-collection/:campaign

Query Parameters

Parameter Required Type Default Description
access_token Yes string   Activ8 Plus API Access Token
start_date No string 30 days ago ISO-8601 formatted date for beginning of date range (see Timeframe)
end_date No string Current date ISO-8601 formatted date for end of date range (see Timeframe)
timezone No string UTC UTC Offset for date range e.g. “-7:00” (see Timezone)

Response

{ "result": 133 }

Timeframe
timeframe

Timeframe Parameters

Timezone Description
US/Eastern The Eastern timezone in the U.S., either standard or daylight.
US/Central The Central timezone in the U.S., either standard or daylight.
US/Mountain The Mountain timezone in the U.S., either standard or daylight.
US/Pacific The Pacific timezone in the U.S., either standard or daylight.
US/Alaska The Alaskan timezone in the U.S., either standard or daylight.
US/Hawaii The Hawaiian timezone in the U.S. Hawaii doesn’t observe DST, pretty easy for us!
UTC The UTC timezone.
Timezone
timezone

Timezone Parameters

Timezone Description
US/Eastern The Eastern timezone in the U.S., either standard or daylight.
US/Central The Central timezone in the U.S., either standard or daylight.
US/Mountain The Mountain timezone in the U.S., either standard or daylight.
US/Pacific The Pacific timezone in the U.S., either standard or daylight.
US/Alaska The Alaskan timezone in the U.S., either standard or daylight.
US/Hawaii The Hawaiian timezone in the U.S. Hawaii doesn’t observe DST, pretty easy for us!
UTC The UTC timezone.