How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hootsuite Analytics API

Hootsuite Analytics API

Hootsuite Analytics API is one of 21 APIs that Hootsuite publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include analytics-api. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

This API exposes 4 operations across 4 paths, and defines 48 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, https://platform.hootsuite.com.

4 operations 4 paths 48 schemas 4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://platform.hootsuite.com/v1
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Hootsuite Analytics API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 2 scopes. By default, every request must be authenticated.

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 POST. Each is listed below with its method, path, parameters, and response codes.

analytics-api 4

Hootsuite Analytics API

POST
/v1/analytics/posts
List Posts and Metrics
listPosts 4 params body → 200default
POST
/v1/analytics/profiles
List Profiles and Metrics
listProfilesMetrics 4 params body → 200default
POST
/v1/analytics/paid/{adEntityCollection}
List Paid campaigns, ad sets, or ads
listPaid 5 params body → 200default
POST
/v1/analytics/paid/{adEntityCollection}/metrics
List Metrics for paid campaigns, ad sets, or ads
listPaidMetrics 5 params body → 200default

Schemas 48

The contract defines 48 schemas that model the data the API accepts and returns. The most detailed are Ad (27 properties), Post (21 properties), AdSet (17 properties), Campaign (15 properties). Each schema is shown below with its type and property counts.

PageMetricsOverview
object
All page level metrics in a single object. Keys are metric names (e.g. "pagereactions", "totalfollowers"). Values are numeric (float64). For metric definitions…
ListPostsResponse
object
2 properties 2 required
Ad
object
27 properties 21 required
AdAccountFilter
object
filter by adAccountId and organizationId
2 properties 2 required
Post
object
21 properties 5 required
ListPaidResponse
object
Response payload for listing paid entities (campaigns, ad sets, or ads).
2 properties 2 required
TimeFieldFilters
object
Filter by a time field, at least one filter must be specified.
1 property
AdAccountTypeEnum
string
Ad account network type
CampaignContentDailyMetrics
object
Daily metrics snapshot for a paid campaign.
7 properties 7 required
AdLink
object
Link objects associated with the ad.
2 properties 1 required
ProblemDetails
object
5 properties 2 required
ListPostsRequest
object
1 property 1 required
MetricsPublic
object
All social network and Owly metrics in a single map. Keys are metric names (e.g. "likes", "comments", "postviews", "clicks"). Values are numeric (float64). For…
PostMetadata
object
Platform-specific metadata in a single object. Keys and values depend on socialprofiletype. Examples: ispopular, objecttype, isboostedpost, iseligibleforpromot…
AdMedia
object
Thumbnail and media URLs for the ad, when available.
2 properties 2 required
MediaPublic
object
Media item. Do not include thumbnailurl when highresolutionthumbnailurl is present.
8 properties
Lifecycle
object
Schedule window (start and end time), when available.
2 properties
InFilter
array
Options to filter against, at least 1 must match.
BreakdownDimension
object
2 properties 2 required
LinkPublic
object
Link from the post. UTM is excluded (not populated since beginning of 2024).
2 properties
ListPaidMetricsResponse
object
2 properties 2 required
DatatypeEnum
string
API code for this datatype
AdsetContentDailyMetrics
object
Daily metrics snapshot for a paid ad set.
8 properties 8 required
Budget
object
Budget configuration, when available.
2 properties 2 required
Cursor
object
1 property 1 required
LabeledType
object
2 properties 2 required
AdSet
object
Paid ad set entity returned from ad platform integrations.
17 properties 12 required
AdContentDailyMetrics
object
Daily metrics snapshot for a paid ad.
9 properties 9 required
TimespanFilter
object
Timespan to filter against, inclusive. At least one of since or until must be provided.
2 properties
EqFilter
string
Filter by exact match.
DataFieldFilters
object
Filter by a data field, at least one filter must be specified.
2 properties
ListProfilesMetricsRequest
object
1 property 1 required
AttachmentType
string
UTM
object
UTM objects associated with the ad.
5 properties 5 required
RequestFilters
object
3 properties 1 required
PageMetric
object
2 properties 1 required
NetworkTypeEnum
string
API code for this Social Network
ListProfilesMetricsResponse
object
2 properties 2 required
Author
object
6 properties
ListPaidMetricsRequest
object
1 property 1 required
AdRequestFilters
object
3 properties 1 required
Campaign
object
Paid campaign entity returned from ad platform integrations.
15 properties 10 required
CollectionInfo
object
2 properties
AdMetadata
object
Platform-specific metadata in a single object. Keys and values depend on adaccounttype.
AdEntityCollectionEnum
string
Plural collection name used in the URL path. Determines whether the response contains campaigns, ad sets, or ads
ProfileMetricsEntry
object
4 properties 4 required
Metadata
object
1 property 1 required
ListPaidRequest
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hootsuite-analytics-api-api-openapi.yml Raw ↑

Other APIs Hootsuite publishes across the network.

Hootsuite Developer Documentation MCP
Hootsuite Authentication API
Hootsuite Comments API
Hootsuite CRM Rest API
Hootsuite CRM Webhooks API
Hootsuite Me API
Hootsuite Media API
Hootsuite Members API
Hootsuite Messages API
Hootsuite Organizations API
Hootsuite Proactive Messaging Rest API
Hootsuite Queue Rest API
Where this information came from

This is an independent, third-party profile of Hootsuite Analytics API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.