> ## Documentation Index
> Fetch the complete documentation index at: https://tryunsora.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Refresh analytics

> Fetch current metrics for your posts from every platform now, instead of waiting for the next scheduled poll.

Polls the platforms for your posts published in the last 90 days and stores fresh figures. Posts read in the last 15 minutes (3 hours for X) are skipped. The response comes back when polling finishes; then call [Analytics summary](https://tryunsora.com/docs/api-reference/analytics/summary.md).

```bash theme={null}
curl -X POST "https://mvp.tryunsora.com/api/v1/posts/analytics/refresh" \
  -H "Authorization: Bearer uns_YOUR_API_KEY"
```


## OpenAPI

````yaml POST /posts/analytics/refresh
openapi: 3.1.0
info:
  title: Unsora API
  version: 1.4.0
  description: >-
    Public API for Unsora integrations. Authenticate with an Unsora API key
    (`uns_…`, created under Developers → API keys in the app) as a Bearer token
    in the Authorization header. Limit: 60 requests per minute per key; over it,
    429 with code RATE_LIMIT_EXCEEDED.
servers:
  - url: https://mvp.tryunsora.com/api/v1
    description: Production
  - url: /api/v1
    description: This server
security: []
tags:
  - name: User
  - name: Models
    description: >-
      Every video, image and motion-control model, with each model's inputs
      taken from the provider's own request schema and prices quoted live. One
      generate endpoint covers all of them.
  - name: Video
  - name: Image
  - name: Influencer
  - name: Thumbnail
  - name: Clipping
  - name: Music
  - name: Voiceover
  - name: Upscaler
  - name: Subtitle removal
  - name: Motion control
  - name: Avatar
  - name: Movie materials
  - name: Voice clones
  - name: Voice changer
  - name: Uploads
  - name: Scheduler
paths:
  /posts/analytics/refresh:
    post:
      tags:
        - Scheduler
      summary: Refresh post metrics from the platforms
      description: >-
        Polls the platforms for current metrics of the caller's posts published
        in the last 90 days (YouTube, TikTok, Instagram, Facebook, Threads,
        Pinterest, LinkedIn, Bluesky, X, Google Business Profile) and stores a
        snapshot for each. Posts read in the last 15 minutes (3 hours for X) are
        skipped. The response is returned after polling finishes. Accounts whose
        platform request fails are skipped. Call GET /posts/analytics/summary
        afterwards for the updated figures.
      responses:
        '200':
          description: Refresh finished
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsRefreshResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    AnalyticsRefreshResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
          properties:
            refreshed:
              type: integer
              description: >-
                Number of per-account posts that received a new metrics
                snapshot.
          required:
            - refreshed
      required:
        - success
        - data
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        error:
          type: string
        code:
          type: string
        message:
          type: string
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: An Unsora API key (`uns_…`). A Clerk session token also works.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.