---
title: "Returns the list of Facebook posts created during a period of time."
method: GET
path: "/v2/analytics/posts/facebook"
tags: ["Facebook Analytics Service"]
---

# Returns the list of Facebook posts created during a period of time.

`GET /v2/analytics/posts/facebook`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/analytics/posts/facebook`
- Auth: none declared

## Query parameters

- `from` string, required
- `to` string, required
- `timezone` string

## Response `200`

OK

- JsonOkListResponseFacebookPost
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` FacebookPost[]
    - `blogId` integer
    - `pageId` string
    - `postId` string
    - `created` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `timestamp` integer
    - `link` string
    - `text` string
    - `type` string
    - `shares` integer
    - `comments` integer
    - `reactions` integer
    - `like` integer
    - `love` integer
    - `wow` integer
    - `haha` integer
    - `sorry` integer
    - `anger` integer
    - `impressions` integer
    - `impressionsPaid` integer
    - `impressionsOrganic` integer
    - `impressionsUnique` integer
    - `impressionsUniquePaid` integer
    - `impressionsUniqueOrganic` integer
    - `clicks` integer
    - `engagement` number, double
    - `picture` string
    - `videoViews` integer
    - `videoViewsPaid` integer
    - `videoViewsOrganic` integer
    - `videoTimeWatched` integer
    - `linkclicks` integer
    - `spend` number, double
    - `ownerScreenName` string
    - `ownerDisplayName` string
    - `ownerPicture` string
    - `internalSearchId` string

## Changes

- **2026-10-19** `b51dcfc02f38`: 2 info
  - api operation id `downloadFacebookPostsCSV_1` removed and replaced with `getFacebookPosts`
  - added the media type `application/json` for the response with the status `200`
- **2026-10-19** `6bd5f8435492`: 1 breaking, 1 info
  - removed the media type `application/json` for the response with the status `200`
  - api operation id `getFacebookPosts` removed and replaced with `downloadFacebookPostsCSV_1`
- **2026-10-19** `28c3aa47609c`: 2 info
  - api operation id `downloadFacebookPostsCSV_1` removed and replaced with `getFacebookPosts`
  - added the media type `application/json` for the response with the status `200`

[Operation history](https://skmtc.dev/metricool/apis/metricool-api/changes/v2/analytics/posts/facebook/get.md)

---

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