How a creator's posts moved between crawls

Per-post metric history, ranked by views. Each post carries its first and last reading in the window plus the change between them; pass include_points=true for every individual reading. Values are the readings that exist — a crawl date missing for a post means no crawl covered it, not a zero.

get/api/v1/creators/{id_token}/timeline

Request

Base URL: https://api.adsmom.com
URL: https://api.adsmom.com/api/v1/creators/{id_token}/timeline
Auth: HTTP bearer

Path parameters

id_tokenstring required

Query parameters

date_fromstring

Window start (ISO 8601).

date_tostring

Window end (ISO 8601).

include_pointsstring

Include every individual crawl reading per post. Off by default: points multiply the payload by the number of crawl dates, so the page size is reduced when this is on.

cursorstring

Opaque pagination cursor. Pass back next_cursor.

limitnumber

Posts per page, most viewed first. Clamped harder when include_points=true.

Response

crawl_datesstring[] required

Crawl dates covered by the posts on THIS page, ascending. Scoped to the page, so it can differ between pages of the same creator.

Example response

{
  "pagination": {
    "next_cursor": "eyJrIjoiMTIzNCIsImQiOiJuZXh0In0",
    "has_more": true
  }
}

Changes

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