Skip to main content

Get Instagram Publishing Limit

Returns the connected Instagram account's content-publishing quota, capped at Upload-Post's 24-hour limit (50 posts/24h per Limit of uploads).

  • Method: GET
  • Endpoint: /api/uploadposts/instagram/publishing_limit
  • Authentication: API Key — Authorization: Apikey <YOUR_API_KEY>

Query Parameters

ParameterTypeRequiredDescription
profilestringYesThe profile's username. Alias: user.
refreshbooleanNoWhen true, skip the cache and fetch from Instagram.

Example Request

curl -G 'https://api.upload-post.com/api/uploadposts/instagram/publishing_limit' \
-H 'Authorization: Apikey your-api-key-here' \
-d 'profile=your_profile'

Successful Response (200 OK)

{
"success": true,
"platform": "instagram",
"profile": "your_profile",
"quota_usage": 12,
"quota_total": 50,
"quota_duration": 86400,
"remaining": 38,
"limit_reached": false,
"fetched_at": "2026-09-08T12:00:00Z",
"cached": true
}

When the quota is exhausted, uploads fail with error_code: "instagram_publishing_limit_reached".