Instagram Creator Marketplace API

• instagram_creator_marketplace_discovery
• instagram_basic
• pages_manage_metadata
• pages_show_list
• business_management

• Account-level limits: Requests are capped at 1000 per user per hour.
• Application-level limits: The number of calls an app can make within a rolling one-hour window is calculated as: Calls per hour = 1000 * Number of Effective Users. Number of Effective Users is determined by the app’s number of unique daily active users (DAUs). If your app experiences fluctuating usage, such as higher activity on weekends and lower activity during weekdays, the calculation may use weekly or monthly active users to better reflect typical usage patterns instead.

• UI (user-facing) apps:
  • Before you begin recording your demo for app review, ensure that you have included the instagram_creator_marketplace_discovery permission in your configuration. You can access this permission by using the existing Instagram Creator Marketplace template during setup.
  • Show the complete, end-to-end Facebook Login flow inside your app. The login flow should match the video in the Login Flow Experience section below as closely as possible.
  • Show the user connecting their Instagram account via a linked Facebook Page.
  • Clearly show where the user (brand) reviews and grants consent for creator search. Your app review video should clearly show the list of permissions and ensure that “Discover content creators on the Instagram Creator Marketplace platform” is visible.
  • Example screencast: How to produce a screencast for app review
• Server-to-server (S2S, no UI) apps:
  • Explain your backend authentication setup (system users, tokens, permissions).
  • Clearly state that your app is server-to-server in your submission.
  • Confirm in the screencast that the app operates as S2S.
  • If direct testing isn’t possible, provide detailed use cases and evidence supporting the S2S workflow.

    2. End-to-End Permission Usage
    1. Explain and demonstrate how you use the instagram_creator_marketplace_discovery permission to discover creators. Include the specific purpose for why the app needs this functionality.
    2. In your recorded video, demonstrate how you perform a creator search on your app UI using the Instagram Creator Marketplace API.
    3. Show how your app retrieves and processes creator insights, such as creator bio, follower count, and account reach.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/v25.0/<IG_USER_ID>/creator_marketplace_creators'

• When a creator username is specified, other filter parameters (e.g., creator_countries) cannot be applied.
• When similar_to_creators is used, keyword search (query) cannot be used.
• query can be combined with other filters (e.g., creator_age_bucket).
• If the searched username (username) matches the username of an eligible professional account, that account will be returned regardless of its creator marketplace onboarding status.

curl -G \
  -d 'creator_countries=["US"]' \
  -d 'fields=id,username,country,gender' \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/v25.0/<IG_USER_ID>/creator_marketplace_creators'

{
  "data": [
    {
      "id": "178414869381437360",
      "username": "xxx",
      "country": "BR",
      "gender": "female"
    },
    {
      "id": "178414965628223823",
      "username": "xxx",
      "country": "IN",
      "gender": "male"
    }
  ]
}

curl -G \
  -d 'username=<CREATOR_USERNAME>' \
  -d 'fields=insights.metrics(creator_reach).breakdown(follow_type)' \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/v25.0/<IG_USER_ID>/creator_marketplace_creators'

curl -G \
  -d 'username=<CREATOR_USERNAME>' \
  -d 'fields=branded_content_media{media_type,insights.metrics(views)},recent_media{media_type,insights.metrics(views)}' \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/v25.0/<IG_USER_ID>/creator_marketplace_creators'

• instagram_creator_marketplace_discovery
• instagram_basic
• ads_management

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/v25.0/<IG_USER_ID>/creator_marketplace_brand_info'

curl -G \
  -d 'acting_business_id=123456' \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/v25.0/<IG_USER_ID>/creator_marketplace_brand_info'

{
  "custom_audiences_access_status": "HAS_ACCESS",
  "custom_audiences": [
    {
      "id": "12354465435359",
      "name": "High Value Customers Q1"
    },
    {
      "id": "5645451351544564",
      "name": "Website Visitors 30d"
    }
  ]
}

• App Review process
• Facebook Login