Stack Overflow

List Stack Overflow post timeline

List everything that happened to a Stack Overflow post: edits, locks, answers, comments, votes and reviews.

GET/v1/stack-overflow/posts/{postId}/timeline
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
postIdintegerrequiredpath

Post id (a question or an answer) on the chosen site, e.g. `11227902`.

≥ 1 · ≤ 2147483647

sitestringoptionalquery

Stack Exchange site, by its API name (`askubuntu`, `serverfault`, `math`, `ru.stackoverflow`). Default: `stackoverflow`. The sites endpoint lists them all.

typesarrayoptionalquery

Only these kinds of event, comma-separated: `answer`, `comment`, `history`, `review`, `vote`, `other`. Default: all.

any of: answer, comment, history, review, vote, other (comma-separated)

limitintegeroptionalquery

Up to this many rows per page, 1 to 100. Default: 30. A page can hold fewer than `limit` rows where rows share a creation second or a block of 100 rows ends. Follow `page.nextCursor` until `hasMore` is false.

≥ 1 · ≤ 100

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters.

min 1 chars · max 1024 chars

Response fields
26

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the post does not exist or was deleted.

one of: found, not_found

datasite
string

The Stack Exchange site the post belongs to.

datapostId
integer

The post the timeline belongs to.

datatitle
stringnullable

Title of the question the post belongs to.

datalicense
stringnullable

The post's current licence, e.g. `CC BY-SA 4.0`.

The events on this page, in the order the site lists them.

dataevents[]id
string

Identifier of the event (a number, or a revision id for edits). Review events can share an id, so `id` is not unique within a response; use `type`, `at`, `action` and `actor` to tell those events apart.

dataevents[]type
string

Kind of event: an `answer` being added, a `comment`, a `history` entry (an edit, a close, a lock), a `review`, a `vote` (an accept or a bounty) or `other`.

one of: answer, comment, history, review, vote, other

dataevents[]at
stringnullable

When it happened, ISO 8601 UTC.

dataevents[]action
stringnullable

What happened, in the site's words, e.g. `edited`, `added` or `accept`.

Who did it; null for events with no user.

dataevents[]actorid
integernullable

User id; null when the row does not carry it.

dataevents[]actorname
stringnullable

Display name.

dataevents[]actorurl
stringnullable

Profile URL.

dataevents[]license
stringnullable

Licence of the revision, e.g. `CC BY-SA 4.0`.

dataevents[]detail
stringnullable

The event's text: an edit summary, a comment, or an answer's score.

dataevents[]linkedPostId
integernullable

The post the event refers to, e.g. the answer that was added.

dataevents[]isDeleted
boolean

Whether the site marks the event as deleted.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/stack-overflow/posts/11227902/timeline?types=history" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Timeline listing.