INinfluencity
Content Tracking

Create a custom tracking

Creates a custom content tracking for the authenticated brand.

post/content-tracking/v1/trackings

Request

  • Base URL
    https://api.influencity.com
  • Auth
    HTTP bearer

Request body

namestring required

Tracking display name (unique per brand).

descriptionstring

Optional tracking description. Not returned in the public 201 body.

hashtagsstring[]

Hashtag filters (max 5). Omit or pass [].

mentionsstring[]

Mention filters (max 5). Omit or pass [].

keywordsstring[]

Keyword filters (max 5). Omit or pass [].

profileIdsstring[]

Optional profile ObjectIds to attach. Alone is not enough; content filters are required.

startDatestring required

Tracking start date (YYYY-MM-DD). Required. Must not be in the past (UTC). If it is today UTC, the tracking starts immediately.

endDatestring required

Tracking end date (YYYY-MM-DD). Required; must be >= startDate.

Example request

{
  "name": "My Campaign Tracking",
  "description": "Q3 brand mentions",
  "hashtags": [
    "#brand"
  ],
  "mentions": [
    "@handle"
  ],
  "keywords": [
    "keyword"
  ],
  "profileIds": [
    "507f1f77bcf86cd799439011"
  ],
  "startDate": "2027-01-15",
  "endDate": "2027-06-30"
}

Response

Custom tracking created.

trackingIdstring required

Created tracking identifier.

namestring required

Tracking display name.

statusstring required

Tracking status.

startDatestring required

Normalized start date. Today UTC is returned as the instant the tracking started.

endDatestring required

Normalized end date.

createdFromstring required

Origin of the tracking. Public API creates always report api.

Example response

{
  "trackingId": "507f1f77bcf86cd799439011",
  "name": "My Campaign Tracking",
  "status": "active",
  "startDate": "2027-01-15T00:00:00.000Z",
  "endDate": "2027-06-30T23:59:59.999Z",
  "createdFrom": "api"
}

Changes

No recorded changes to this operation across all 1 revision of this API.