Posts Api Service

Get the scheduled posts between two dates or an uuid.

Changed on
get/v2/scheduler/posts

Request

  • Base URL: https://app.metricool.com/api
  • URL: https://app.metricool.com/api/v2/scheduler/posts
  • Auth: none declared

Query parameters

startstring

The start date from you want to return the posts. ('2011-12-03T10:15:30')

endstring

The date until you want to return the posts. ('2011-12-04T10:15:30')

timezonestring

The timezone in which you want to return the posts. ('Europe/Madrid')

filterstring

Json filter that must have publicationDate and providers or a valid uuid (both are not allowed, just one uuid or just publicationDate and providers) If the filter is set none of the other params are taken into account

extendedRangestring

(Optional) When it's true, search date range is expanded one day after and one day before to avoid timezone changes issues. Default value is false

Response

OK

metadataobject

Example response

{
  "data": [
    {
      "tiktokData": {
        "articleLink": {
          "url": "https://www.efe.com/article",
          "title": "Check this out"
        }
      },
      "notes": [
        {
          "mentions": [
            {
              "userId": 12345,
              "agencyId": 37,
              "agencyUserId": 156
            }
          ],
          "mentionId": "a:37:156"
        }
      ],
      "brandTags": [
        {
          "id": 123,
          "name": "Summer 2026",
          "color": "#4A90E2"
        }
      ]
    }
  ]
}

Changes

  • b51dcfc02f38Revision changes
    • info

      api operation id getCalendarReport removed and replaced with retrievePosts_1

    • info

      added the new optional query request parameter extendedRange

    • info

      added the new optional query request parameter filter

    • info

      added the media type application/json for the response with the status

  • 6bd5f8435492Revision changes
    • breaking

      removed the media type application/json for the response with the status

    • warning

      deleted the query request parameter extendedRange

    • warning

      deleted the query request parameter filter

    • info

      api operation id retrievePosts_1 removed and replaced with getCalendarReport