---
title: "Refresh social performance data"
method: POST
path: "/v1/analytics/refresh"
tags: ["Analytics"]
---

# Refresh social performance data

`POST /v1/analytics/refresh`

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/analytics/refresh`
- Auth: HTTP bearer

Fetch fresh platform metrics for your published content. Can target one post or video; otherwise refreshes a bounded recent batch (100 posts, 50 videos). May stop early to stay within the request time budget; skipped counts unrefreshed platform metrics. Refresh those posts individually after the cooldown. Limited to one refresh per user every five minutes across instances. Returns real successes and failures; missing metrics are not zero performance.

## Request body

- object
  - `postId` string, uuid
  - `postType` 'post' | 'video'

## Response `200`

Successful response.

- object
  - `success` true, required
  - `data` object, required
    - `fetched` number, required
    - `errors` number, required
    - `postsProcessed` number
    - `skipped` number
    - `platformsUpdated` string[]
    - `message` string, required

## Other responses

- `400`: Invalid input.
- `404`: Not found or not owned.
- `409`: Content changed or cannot be edited in its current state.

---

[API](https://skmtc.dev/postquick/apis/postquickai-api.md) · [All operations](https://skmtc.dev/postquick/apis/postquickai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postquick/apis/postquickai-api/revisions/d9bc2bcf3042?raw)