---
title: "List Profiles and Metrics"
method: POST
path: "/v1/analytics/profiles"
tags: ["Analytics"]
---

# List Profiles and Metrics

`POST /v1/analytics/profiles`

## Request

- Base URL: `https://platform.hootsuite.com`
- URL: `https://platform.hootsuite.com/v1/analytics/profiles`
- Auth: OAuth 2
  - Authorization code: `https://platform.hootsuite.com/oauth2/auth`
  - Token URL: `https://platform.hootsuite.com/oauth2/token`

Fetch daily analytics metrics for profiles on this social network.
`profileId` is a required filter, the others are optional. `lastModified` may start at most 30 days in the past.  `reportingPeriod` may start at most 2 years in the past.

## Query parameters

- `datatype` 'ORGANIC' | 'PAID': API code for this datatype
- `networkId` 'FACEBOOKPAGE' | 'TWITTER' | 'INSTAGRAMBUSINESS' | 'TIKTOKBUSINESS' | 'YOUTUBECHANNEL' | 'PINTEREST' | 'THREADS': API code for this Social Network
- `cursor` string
- `limit` integer

## Request body

- ListProfilesMetricsRequest
  - `filters` RequestFilters, required
    - `profileId` DataFieldFilters, required: Filter by a data field, at least one filter must be specified.
      - `eq` string: Filter by exact match.
      - `in` string[]: Options to filter against, at least 1 must match.
    - `lastModified` TimeFieldFilters: Filter by a time field, at least one filter must be specified.
      - `timespan` TimespanFilter: Timespan to filter against, inclusive. At least one of `since` or `until` must be provided.
        - `since` string, date: Start of query, if omitted defaults to 1 year ago
        - `until` string, date: End of query, if omitted defaults to now
    - `reportingPeriod` TimeFieldFilters: Filter by a time field, at least one filter must be specified.
      - `timespan` TimespanFilter: Timespan to filter against, inclusive. At least one of `since` or `until` must be provided.
        - `since` string, date: Start of query, if omitted defaults to 1 year ago
        - `until` string, date: End of query, if omitted defaults to now

## Response `200`

Profiles metrics returned.

- ListProfilesMetricsResponse
  - `data` ProfileMetricsEntry[], required
    - `profileId` string, required: Hootsuite identifier of this social profile.
    - `externalProfileId` string, required: Identifier of the social profile on the social network.
    - `date` string, date, required: date of the metrics
    - `metrics` PageMetricsOverview, required: All page level metrics in a single object. Keys are metric names (e.g. "page_reactions", "total_followers"). Values are numeric (float64). For metric definitions, see the Help Center documentation.
  - `metadata` Metadata, required
    - `collectionInfo` CollectionInfo, required
      - `next` Cursor
        - `cursor` string, required: Cursor for the next/prev page of data, if available
      - `prev` Cursor
        - `cursor` string, required: Cursor for the next/prev page of data, if available

## Other responses

- `default`: An error occurred.

---

[API](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api.md) - [All operations](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api/revisions/adac53bd28bb?raw)