Insights

Get the top posts

Returns top posts published on the requested calendar dates in the authenticated user's timezone, ranked by specified metrics from Analytics-permitted accounts.

get/insights/posts/top_posts

Request

  • Base URL: https://socialbu.com/api/v1
  • URL: https://socialbu.com/api/v1/insights/posts/top_posts
  • Auth: HTTP bearer

Query parameters

limitinteger

Maximum number of ranked posts to return.

startstring date required

The start date and format should be Y-m-d.

endstring date required

The end date and format should be Y-m-d.

string required
OR
string[] required

The metric types you want to rank posts by. Accepts either a comma-separated string or repeated query parameters such as metrics[]=impressions&metrics[]=engagement. See /insights/posts/metrics for the full list of supported post metrics per network.

accountsinteger[]

An array of account IDs.

teaminteger

The team id

Response

successful operation

Changes

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