---
title: "Get posting history for a social account"
method: POST
path: "/api/history_data"
---

# Get posting history for a social account

`POST /api/history_data`

## Request

- Base URL: `https://social.recurpost.com`
- URL: `https://social.recurpost.com/api/history_data`
- Auth: none declared

Returns up to 100 posts per request for one social account, with a total_posts count for the date range. Without start_date/end_date it returns the last 30 minutes on the first call and everything since the last fetch on subsequent calls.

## Request body

- HistoryRequest
  - `emailid` string, email, required: RecurPost account email address
  - `pass_key` string, required: API Password Key from Account Settings (NOT the login password)
  - `id` string, required: Social account ID from /api/social_account_list
  - `start_date` string: Start of date range, format Y-m-d H:i:s (e.g. 2026-03-01 00:00:00). Default: last 30 minutes, or last fetched time on subsequent requests.
  - `end_date` string: End of date range, format Y-m-d H:i:s. Default: current time.
  - `is_get_video_updates` boolean: Include video posts in the response

## Response `200`

Posting history

- object
  - `total_posts` integer: Total posts matching the date range
  - `data` object[]: Post history records (max 100 per request)

## Other responses

- `400`: Missing or invalid parameters
- `401`: Invalid emailid or pass_key

---

[API](https://skmtc.dev/recurpost/apis/recurpost-public-api.md) - [All operations](https://skmtc.dev/recurpost/apis/recurpost-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recurpost/apis/recurpost-public-api/revisions/c8e270a283a1?raw)