List ad sources

The content the dashboard ad builder offers: creator social posts (newest first), TikTok Shop videos that sold in the range (highest GMV first), or approved content submissions. Each row’s creative_source goes into creative on POST /meta_ads/bulk.

GET /meta_ads/sources

cURL

curl -X GET "https://api.growi.io/api/public/v1/meta_ads/sources?source=social_posts&ad_attachment=not_attached&start_date=2026-10-01&end_date=2026-10-14" \
     -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "success": true,
  "source": "social_posts",
  "data": [
    {
      "source": "social_post",
      "id": "instagram:3456789012345678901",
      "creative_source": {
        "social_post_id": "instagram:3456789012345678901"
      },
      "platform": "instagram",
      "creator": {
        "id": 2628998,
        "name": "Ava Creator",
        "handle": "ava.creates"
      },
      "campaign_id": 123,
      "campaign_affiliate_id": 3490313,
      "thumbnail_url": "https://cdn.growi.io/posts/3456789012345678901.mp4",
      "video_url": "https://cdn.growi.io/posts/3456789012345678901.mp4",
      "share_url": "https://www.instagram.com/reel/DAbCdEf/",
      "posted_at": "Oct 10, 2026",
      "product": {
        "id": 88,
        "name": "Glow Serum"
      },
      "gmv": null,
      "existing_meta_ad": null,
      "meta_ad_code": {
        "code": "AbCdEf123",
        "status": "active"
      },
      "whitelisting_status": "whitelisted",
      "meta_partnership_ad_request_id": 4410
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total_count": 1,
    "total_pages": 1,
    "has_more": false,
    "returned": 1
  }
}

Lists creator content you can turn into Meta ads: social posts (newest first), TikTok Shop videos that sold in the date range (highest GMV first), or approved content submissions.

Step 1 of the Meta ads automation flow.

Sources

source	What it lists	Order	creative_source keys
social_posts (default)	Creator posts Growi tracks for your organization	Newest first	social_post_id
tik_tok_shop_videos	TikTok Shop videos that sold in your shop in the date range	Highest GMV first	tts_external_id, tts_username
submissions	Approved video and image content submissions	Newest first	content_submission_version_id

Pass ad_attachment=not_attached to skip content that already backs an ad. That is the usual filter for a daily job. Dates default to the last 30 days, and a range can be up to 366 days.

Fields to carry into the ad

• creative_source: copy its keys into creative on Create ads in bulk.
• meta_partnership_ad_request_id: when set, send it to run the ad as the creator (a partnership ad).
• whitelisting_status: whitelisted means every Instagram account of the creator approved partnership ads; partial, not_whitelisted and no_instagram mean some, none, or no Instagram account.
• creator.id: pass it as creator_ids to Get builder options for the creator’s tracking link.
• campaign_affiliate_id: the creator enrollment the content is attributed to, when known.

Filters are checked against your organization. A campaign_id, campaign_affiliate_id or creator_id from another organization returns 422, and so does source=tik_tok_shop_videos when no TikTok Shop is connected.

Authentication

Any organization API key works, including view-only keys. A key acts as the person who created it, so that person needs the owner, admin or viewer role. See Rate limits and authentication.

Errors

Status	When
401	Missing or invalid API key, or the person who created the key is no longer an owner, admin or viewer of the organization
404	organization_id is not a child brand of the key’s organization
422	Invalid filter, a filter that points at another organization, or no TikTok Shop connected
429	Rate limited: 2 seconds between requests, and 40 requests per hour per key by default

cURL

curl -X GET "https://api.growi.io/api/public/v1/meta_ads/sources?source=social_posts&ad_attachment=not_attached&start_date=2026-10-01&end_date=2026-10-14" \
     -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "success": true,
  "source": "social_posts",
  "data": [
    {
      "source": "social_post",
      "id": "instagram:3456789012345678901",
      "creative_source": {
        "social_post_id": "instagram:3456789012345678901"
      },
      "platform": "instagram",
      "creator": {
        "id": 2628998,
        "name": "Ava Creator",
        "handle": "ava.creates"
      },
      "campaign_id": 123,
      "campaign_affiliate_id": 3490313,
      "thumbnail_url": "https://cdn.growi.io/posts/3456789012345678901.mp4",
      "video_url": "https://cdn.growi.io/posts/3456789012345678901.mp4",
      "share_url": "https://www.instagram.com/reel/DAbCdEf/",
      "posted_at": "Oct 10, 2026",
      "product": {
        "id": 88,
        "name": "Glow Serum"
      },
      "gmv": null,
      "existing_meta_ad": null,
      "meta_ad_code": {
        "code": "AbCdEf123",
        "status": "active"
      },
      "whitelisting_status": "whitelisted",
      "meta_partnership_ad_request_id": 4410
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total_count": 1,
    "total_pages": 1,
    "has_more": false,
    "returned": 1
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

organization_id · integer

Act on a child brand of the API key's organization. Omit it to act on the key's own organization. Any other id returns 404.

source · enum<string> · default: social_posts

Which content to list.

Available options: social_posts, tik_tok_shop_videos, submissions

campaign_id · integer

Only content attributed to this Growi campaign. Must belong to your organization.

campaign_affiliate_id · integer

Only content from this enrollment. Must belong to your organization.

creator_id · integer

Growi user id of a creator in your organization.

platform · enum<string>

social_posts only.

Available options: instagram, tik_tok, youtube, twitter, facebook

ad_attachment · enum<string> · default: all

attached: content that already backs an ad. not_attached: content without an ad yet.

Available options: all, attached, not_attached

start_date · string

YYYY-MM-DD. Defaults to 30 days before end_date. For submissions the date filter only applies when you send it.

end_date · string

YYYY-MM-DD. Defaults to today. The range can be at most 366 days.

search · string

Free-text search

page · integer · default: 1

Page number

Required range: x >= 1

per_page · integer · default: 25

Rows per page

Required range: 1 <= x <= 100

Response

200

application/json

Content you can build ads from

success · boolean

Always true on 200

source · string

The source you asked for

data · object[]

Show child attributes

meta · object

Show child attributes