IG User Content Publishing Limit

Represents an IG User's current content publishing usage.

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User user access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic` `instagram_business_content_publish`	`instagram_basic` `instagram_content_publish` `pages_read_engagement` `pages_show_list` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `business_management`

Creating

This operation is not supported.

Reading

GET /<IG_USER_ID>/content_publishing_limit

Get the number of times an IG User has published and IG Container within a given time period. Refer to the Content Publishing guide for complete publishing steps.

Request Syntax

GET https://graph.facebook.com/&lt;API_VERSION>/&lt;IG_USER_ID>/content_publishing_limit
  ?fields=&lt;LIST_OF_FIELDS>
  &since=&lt;UNIX_TIMESTAMP>
  &access_token=&lt;ACCESS_TOKEN>

Query String Parameters

Placeholder	Value Description
`<ACCESS_TOKEN>` Required String	The app user's User Access Token.
`<LIST_OF_FIELDS>` Comma-separated list	A comma-separated list of fields you want returned. If omitted, the `quota_usage` field will be returned by default.
`<UNIX_TIMESTAMP>` Unix timestamp	A Unix timestamp no older than 24 hours.

Fields

Field Value Description

Field	Value Description
`config` Object	Returns these values: `quota_total` — The maximum number of IG Containers the app user can publish within the `quota_duration` time period (currently `50`). `quota_duration` — The period of time in seconds against which the `quota_total` is calculated (currently `86400` seconds, or 24 hours).
`quota_usage` Comma-separated list	The number of times the app user has published an IG Container since the time specified in the `since` query string parameter. If the `since` parameter is omitted, this value will be the number of times the app user has published a container within the last 24 hours. This field is returned by default if the `fields` query string parameter is omitted from the query.

config
Object

Returns these values:

quota_total — The maximum number of IG Containers the app user can publish within the quota_duration time period (currently 50).
quota_duration — The period of time in seconds against which the quota_total is calculated (currently 86400 seconds, or 24 hours).

quota_usage
Comma-separated list

The number of times the app user has published an IG Container since the time specified in the since query string parameter. If the since parameter is omitted, this value will be the number of times the app user has published a container within the last 24 hours. This field is returned by default if the fields query string parameter is omitted from the query.

Example Request

curl -X GET \
  'https://graph.facebook.com/v21.0/17841405822304914/content_publishing_limit?fields=quota_usage,rate_limit_settings&since=1609969714&access_token=IGQVJ...'

Example Response

{
  "data": [
    {
      "quota_usage": 2,
      "config": {
        "quota_total": 50,
        "quota_duration": 86400
      }
    }
  ]
}

Updating

This operation is not supported.

Deleting

This operation is not supported.