Posts of a period with their numbers

GET

/analytics/posts

curl --request GET \
  --url 'https://api.dropslate.top/v1/analytics/posts?sort=views&page=1&perPage=10' \
  --header 'Authorization: Bearer <token>'

• Production

Authorizations

• bearerAuth

Parameters

Query Parameters

from

string format: date

UTC day, included. Default: 29 days before to. Moved up to the plan’s history (Free 30 days, Creator 90, Studio and Agency 365).

to

string format: date

UTC day, included. Default: today. At most 366 days after from.

accountIds

string

Comma-separated; an id of another workspace answers 404.

platforms

string

Comma-separated, e.g. youtube,instagram.

sort

string

default: views

Allowed values: views engagementRate liveAt

page

integer

default: 1 >= 1

perPage

integer

default: 10 >= 1 <= 100

Responses

200

One row per live post, highest first.

Media typeapplication/json

object

posts

Array<object>

object

postId

string

platform

string

Allowed values: youtube instagram facebook threads tiktok

accountId

string

account

object

displayName

string

handle

string

nullable

title

string

thumbnailUrl

string

nullable

externalUrl

string

nullable

liveAt

string format: date-time

views

Null when the network gives no such metric; never 0 for unknown.

integer

nullable

likes

Null when the network gives no such metric; never 0 for unknown.

integer

nullable

comments

Null when the network gives no such metric; never 0 for unknown.

integer

nullable

shares

Null when the network gives no such metric; never 0 for unknown.

integer

nullable

saves

Null when the network gives no such metric; never 0 for unknown.

integer

nullable

engagementRate

Engagements per view; null when either is unknown or nothing was viewed.

number

nullable

updatedAt

string format: date-time

nullable

page

integer

perPage

integer

total

integer

Example

{
  "posts": [
    {
      "platform": "youtube"
    }
  ]
}

400

A date or filter that is not one (invalid_request).

Media typeapplication/json

object

code

required

string

message

required

string

hint

string

Example

{
  "code": "not_found",
  "message": "The post does not exist.",
  "hint": "Check the id and try again."
}

404

Does not exist, or belongs to a different workspace - the two look identical from here.

Media typeapplication/json

object

code

required

string

message

required

string

hint

string

Example

{
  "code": "not_found",
  "message": "The post does not exist.",
  "hint": "Check the id and try again."
}