Meta Branded Content & Instagram Paid Partnerships Scraper
Pricing
from $2.40 / 1,000 partnership records
Meta Branded Content & Instagram Paid Partnerships Scraper
Find Instagram paid partnerships and brand collaborations from Meta Branded Content Library: enter brand or creator usernames or profile URLs and get creator, brand partners, date, post/reel/story type and link. No login. $0.004 per record.
Pricing
from $2.40 / 1,000 partnership records
Rating
0.0
(0)
Developer
Automation Lab
Maintained by CommunityActor stats
0
Bookmarked
3
Total users
2
Monthly active users
2 days ago
Last modified
Categories
Features
Share
Meta Branded Content Partnerships Scraper
Export Instagram paid partnerships and brand collaborations from Meta Branded Content Library. Enter Instagram usernames or profile URLs, such as nike or https://www.instagram.com/sephora/, and get every listed partnership: creator and brand handles, publication date, content type (post, reel or story), the Instagram link and the Library source URL. No Instagram or Facebook account is needed.
Who is it for?
Influencer marketing agencies, brand teams and researchers who want to know which creators a brand pays, or which brands a creator works with. The records are Meta's own "Paid partnership" disclosures, not sponsorships guessed from hashtags or tags.
What does this Actor do?
You list up to 20 Instagram profiles (brands or creators) and an optional date range. For each profile the Actor looks up its Library entry and exports the partnership records Meta lists for it:
- for a brand, the creators who published paid-partnership content with it;
- for a creator, the brands it partnered with.
Each record keeps every listed brand partner and says which of your profiles returned it (searchedProfile). A record found under two of your profiles is saved and charged once.
It does not cover Facebook partnerships, private accounts, follower counts, engagement metrics or media downloads. Unknown usernames are skipped, named in the status message and not charged.
Why use this Actor?
- Just usernames: no need to find a Library ID first; paste profile URLs or handles, many at once.
- Explicit relationships: Meta's disclosed creator-to-brand partnerships, with links to verify each record.
- Cheaper per record: $0.004 per partnership record on the Starter plan, below the main alternatives.
- Honest coverage: the status message says how many records were found against the limit and why the run stopped.
There is no built-in database of past sponsorships or change alerts. Use Apify schedules and compare runs by contentId downstream.
Getting started
- Enter one or more Instagram usernames or profile URLs in Instagram profiles.
- Optionally set a start and end date. Without them, the last 90 days are read.
- Set Maximum partnership records per profile and start the Actor.
- Download the dataset as JSON, CSV, Excel or another Apify-supported format.
You can still paste a Library URL copied after selecting a business or creator in Meta Branded Content Library, either into Instagram profiles or into Library URL. Its numeric id selects the entity and its dates apply unless you override them.
Input example
{"profiles": ["nike", "https://www.instagram.com/sephora/"],"startDate": "2026-08-01","endDate": "2026-10-31","maxItems": 50}
This requests up to 50 partnership records per profile published from August 1 to October 31, 2026, inclusive.
Input parameters
| Parameter | Meaning |
|---|---|
profiles | Instagram usernames (nike, @nike), profile URLs or selected-entity Library URLs. Up to 20 per run. |
libraryUrl | Optional single selected-entity Library URL (id and target=instagram required). Kept for existing inputs. |
startDate | Optional inclusive YYYY-MM-DD start. Default: 90 days before today, or a Library URL's start_date. |
endDate | Optional inclusive YYYY-MM-DD end. Default: today, or a Library URL's end_date (which Meta treats as exclusive). |
maxItems | Records per profile, default 100, range 1–1,000. |
Dates must be real calendar dates and span no more than 366 days. Invalid usernames, unsupported URLs, Facebook profile URLs and reversed dates fail before anything is charged.
The Actor uses company-paid Apify proxies automatically. No proxy credentials, Instagram or Facebook account or cookies are requested from you.
Extracted data
| Field | Meaning |
|---|---|
contentId | Source content ID; stable key for deduplication and comparisons. |
publicationDate | Library publication date, YYYY-MM-DD. |
creator | Instagram handle and canonical profile URL. |
brandPartners | Array of Instagram brand handles and profile URLs. |
contentType | post, reel or story as reported by the source. |
contentUrl | Instagram post, Reel or Story link. |
platform | Always instagram. |
sourceUrl | Library URL of the searched profile with the effective date range. |
searchedProfile | The profile from your input that returned this record, as you entered it. |
These are source-reported relationships, not estimates of contract value, paid-ad spend, audience size or campaign effectiveness.
Output example
A public record observed in the Library during development:
{"contentId": "18574970662003190","publicationDate": "2026-03-27","creator": {"handle": "oemerpa", "profileUrl": "https://www.instagram.com/oemerpa/"},"brandPartners": [{"handle": "nike", "profileUrl": "https://www.instagram.com/nike/"}],"contentType": "reel","contentUrl": "https://www.instagram.com/reel/DWZOqqYgBf2/","platform": "instagram","sourceUrl": "https://www.facebook.com/ads/library/branded_content/?id=17841400602400210&query=nike&target=instagram&start_date=2026-03-01&end_date=2026-04-01","searchedProfile": "nike"}
The SUMMARY key-value record reports the count, the requested total (maxItems × profiles found), per-profile results (profiles: Library id, records, status), date boundaries, whether the cap was reached, why the run stopped and any days capped at one page (cappedDays). The run's status message says the same, for example Got 180 of 600 partnership records: stopped before the run timeout. A successful export has fewer records than asked for when the available Library pages are exhausted or the run stopped early. Historical content links may expire.
How much does it cost to export Instagram branded content partnerships?
Pay-per-event pricing includes a one-time $0.002 start fee per valid run and a per-record event. The BRONZE rate is $0.004 per partnership record. One record with multiple partners still has one item event. Duplicates, excluded Facebook records, unknown usernames and unsuccessful extraction attempts do not produce item charges.
| Useful records | Estimated BRONZE Actor charge |
|---|---|
| 1 | 0.006 USD estimated total |
| 5 | 0.022 USD estimated total |
| 25 | 0.102 USD estimated total |
| 100 | 0.402 USD estimated total |
From November 30, 2026 the per-record prices on the other plans will be: Free $0.004, Silver $0.0036, Gold and above $0.0032. The Starter (BRONZE) price and the start fee stay the same.
Spend-tier discounts depend on your qualifying aggregate monthly Apify Store spend, not the number of records in this Actor alone. See the Pricing tab for active tier rates. These are estimated Actor charges, not guarantees of invoices or earnings; billing corrections, refunds, disputes and taxes may affect final amounts. Required runtime/proxy services are paid by the company, not an undisclosed external API subscription.
The start event is charged together with the first saved record, so a run that saves nothing costs nothing. Records are charged and saved as each date window is read; you are charged only for records in your dataset.
Coverage and limits
Meta sometimes displays a header count larger than the accessible records. For example, the tested March window displayed 16 while its complete public items page returned 14. Do not equate that header with an export guarantee.
Anonymous GraphQL pagination may be unauthorized. This Actor reads structured server-rendered results and splits date windows when necessary, reusing its anonymous browser session. It allows at most 64 windows per profile and retries a failed window on a fresh page or a new proxy session. Schema and coverage errors stop that profile without an automatic restart; the run moves on to the next profile. Records from windows already read are kept, and the status message names the error, so partial coverage is never silent. When a single day has more than one page, the run keeps that day's first page, moves on to older days and names the capped days in its status message and in SUMMARY.cappedDays.
A full-year range can take several minutes. Shortly before the run's timeout, the Actor stops reading new windows, keeps every record already saved and ends SUCCEEDED with a status giving records delivered, records asked for and the reason. Raise the run timeout or split the range for full coverage.
Meta can mix Facebook links into an Instagram-target result page; these are excluded. No inference is made to replace a missing partnership. Date windows are read newest first and each window's records are saved newest first, but a capped run is not a guarantee of the globally newest N records across every inaccessible source page.
Integrations
- Google Sheets / Excel: append exports keyed by
contentId; compare creator and partner handles between runs. - CRM / research database: store source URLs alongside relationships for analyst review; one record can reference multiple partners.
- Apify schedules: rerun a recent date window and deduplicate in your destination; the Actor itself does not maintain cross-run state.
- Webhooks / Make / Zapier: process successful runs, then retrieve the default dataset. Handle failed coverage jobs separately instead of treating them as empty sponsorship activity.
API usage
Replace APIFY_TOKEN with an environment variable containing your own Apify API token. Never paste credentials into input or published datasets.
cURL
curl -X POST 'https://api.apify.com/v2/acts/automation-lab~meta-branded-content-partnerships/run-sync-get-dataset-items' \-H "Authorization: Bearer $APIFY_TOKEN" \-H 'Content-Type: application/json' \-d '{"profiles":["nike","sephora"],"startDate":"2026-10-01","endDate":"2026-10-31","maxItems":5}'
JavaScript
import { ApifyClient } from 'apify-client';const client = new ApifyClient({ token: process.env.APIFY_TOKEN });const run = await client.actor('automation-lab/meta-branded-content-partnerships').call({profiles: ['nike', 'sephora'],startDate: '2026-10-01',endDate: '2026-10-31',maxItems: 5,});const { items } = await client.dataset(run.defaultDatasetId).listItems();console.log(items);
Python
import osfrom apify_client import ApifyClientclient = ApifyClient(os.environ['APIFY_TOKEN'])run = client.actor('automation-lab/meta-branded-content-partnerships').call(run_input={'profiles': ['nike', 'sephora'],'startDate': '2026-10-01','endDate': '2026-10-31','maxItems': 5,})print(client.dataset(run['defaultDatasetId']).list_items().items)
MCP and AI clients
The Actor does not use AI or send input/output to a model provider. You may separately choose to connect it to your own AI client through Apify MCP once it is available to your account.
Claude Code
claude mcp add --transport http apify \"https://mcp.apify.com?tools=automation-lab/meta-branded-content-partnerships"
Claude Desktop, Cursor, and VS Code
Use the client's HTTP MCP configuration; configure your own authentication separately:
{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=automation-lab/meta-branded-content-partnerships"}}}
Example prompt: “Which creators did Sephora run paid partnerships with in October 2026? Show creator handles and post links.” The tool takes Instagram usernames or profile URLs; it does not infer sponsorships that Meta does not list.
Legality and data handling
Only public Library content IDs, publication dates, creator/brand handles and public URLs are exported. No account passwords, user cookies, private messages or sensitive profile attributes are requested. Browser sessions and cookies are ephemeral and discarded when the browser closes; no cross-run cache is written.
Apify processes and stores your input, dataset, summary and operational logs under your account's storage settings. The Actor does not impose a separate retention timer or delete stored results automatically. Delete run datasets, key-value records and logs through Apify when no longer needed; downstream exports require separate deletion. Company-paid Apify proxy infrastructure receives source requests. Instagram receives the public username lookup and Meta receives the selected public entity/date query. No AI provider receives runtime data.
Use public records responsibly, comply with applicable privacy and platform rules, and retain only information needed for your legitimate research. Public availability does not waive privacy obligations. This is an independent automation-lab tool, not endorsed by or affiliated with Meta, Instagram, Facebook or Apify. It uses Apify's standard user terms, without additional custom restrictions.
Failed runs send sanitized diagnostic input, exceptions and Actor, build and run IDs to our private GlitchTip error-tracking service so we can repair problems. Secret fields and URL query strings are removed, and reports are retained for 30 days.
FAQ and troubleshooting
Which inputs work?
Instagram usernames (nike or @nike), Instagram profile URLs and Library URLs copied after selecting a business or creator. Facebook profile URLs and keyword searches are rejected with a clear message; enter the Instagram username instead.
What happens with a username that doesn't exist?
It is skipped and named in the status message (Not found on Instagram: …), and nothing is charged for it. If none of your profiles exist, the run fails.
Why do I get fewer rows than Meta's count? The header can include unavailable content. Only recognized accessible Instagram records are exported. Facebook links in mixed pages are excluded.
Why did the run stop with fewer rows than I asked for? Check the status message. A run timeout, challenge timeout, changed source schema, overfull single-day page or 64-window ceiling stops the run; records saved before that are kept and charged, and nothing else is. A run that saved nothing fails, because that is not a verified empty result. Retry a narrower range when coverage is the problem. Contact us through the Actor's Apify Issues tab with a run link and sanitized input when the problem persists.
Does an empty export mean no sponsorships happened? No. It means no accessible matching Library records were returned for that entity and period. It does not prove that offline or undisclosed partnerships did not exist.
Related Actors
- Instagram Profile Posts Scraper: inspect public content separately; a post mention is not itself proof of a Library partnership.
- Facebook Ads Library Scraper: research paid ad creatives, a distinct record type from creator-brand partnerships.