# TikTok Brand Sponsor, Paid Partnership & Affiliate Spy (B2B) (`church_of_loujess/tiktok-brand-sponsor-spy`) Actor Spy on brands actively paying TikTok creators right now. Scans any niche for #ad, #sponsored, #partner, promo codes, and tagged @brand campaigns, then resolves advertiser websites, campaign metrics, and verified brand marketing emails. - **URL**: https://apify.com/church_of_loujess/tiktok-brand-sponsor-spy.md - **Developed by:** [H H](https://apify.com/church_of_loujess) (community) - **Categories:** Lead generation, Marketing, E-commerce - **Security:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $15.00 / 1,000 active tiktok brand advertiser & sponsored campaign leads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### What can TikTok Brand Sponsor & Partnership Spy do? **TikTok Brand Sponsor & Partnership Spy** uncovers **DTC, ecommerce, mobile-app, and B2B SaaS brands actively paying TikTok creators right now** β€” scanning any industry vertical for **`#ad`, `#sponsored`, `#partner`, platform paid-partnership flags, creator promo codes, and `@brand` mentions**, then resolving the **advertiser's TikTok profile, live brand website, Instagram, and verified marketing/partnerships emails** in **256 MB RAM**:
πŸ“¦ What you can extract βš™οΈ Features & integrations
🏷️ **Active brand advertisers** (`brandHandleOrName`, `brandTikTokHandle`, `brandTikTokProfileUrl`, `brandFollowers`)
🌐 **Resolved brand websites & emails** (`brandWebsite`, `brandEmails[]`, `brandInstagramUrl`)
🎟️ **Sponsorship & promo signals** (`sponsorSignals[]`, extracted discount `promoCodes[]`, `allMentionedHandles[]`)
🎬 **Sponsored campaign performance** (`videoUrl`, `views`, `likes`, `comments`, `shares`, `bookmarks`, `engagementRatePct`)
πŸ‘€ **Partnered creator telemetry** (`creatorUsername`, `creatorFollowers`, `captionText`, `uploadedAtIso`) 		πŸ•΅οΈ **Multi-signal ad detector** catching `#ad`, `#sponsored`, `Paid partnership`, `Use code`, and `@brand` tags
πŸ•·οΈ **2-hop brand contact resolver** (`resolveBrandContacts: true`) inspecting `@brand` bio -> brand website emails
🎚️ **Strict sponsor filter** (`onlyWithBrandOrSponsorSignal: true`) skipping organic non-commercial posts
⚑ **Zero proxy cost in 256 MB** replaces `$300+/mo` ad-spy tools with Pay-Per-Event API runs
⬇️ **Export advertiser leads** to CSV, Excel, JSON, Clay, Instantly, Smartlead or HubSpot
πŸ€– **Native MCP companion** also live on our Standby `tiktok-intelligence-mcp` server
If you run an influencer agency, UGC studio, newsletter, podcast, or B2B marketing tool, pitching cold brands that have *never* tested creator marketing is uphill. Pitching a brand that **paid a 270K-follower creator for an `#ad` post 4 days ago** means they already have approved creator marketing budget this quarter. ### What data can I extract with TikTok Brand Sponsor & Partnership Spy? Every dataset record links **the sponsored creator video** + **the paying brand's identity and contact details** in a single B2B lead card: - **Sponsorship disclosure & promo-code detection:** *how the paid partnership was structured*. Detects `sponsorSignals` (`hashtag_disclosure` like `#ad`/`#sponsored`/`#partner`, `platform_collab_or_ad_flag`, `promo_code_mention`, `brand_account_mention`), extracts uppercase creator `promoCodes[]` (e.g. `SARAH20`), and lists `allMentionedHandles[]`. - **Advertiser profile + website email resolution:** *turn `@brand` tags into marketing contacts*. When `resolveBrandContacts: true` (default), inspects the tagged `@brand` TikTok account (`brandFollowers`, `brandWebsite`) and crawls the brand's website (`/`, `/contact`, `/pages/contact`) to extract `brandEmails[]` and `brandInstagramUrl`. - **Campaign ROI & creator pairing metrics:** *see which sponsorships crushed and which flopped*. Captures `creatorUsername`, `creatorFollowers`, `views`, `likes`, `comments`, `shares`, `bookmarks`, `engagementRatePct`, `captionText`, `videoUrl`, and `uploadedAtIso`. > Need more specialized workflows? Combine this Actor with these dedicated tools from our suite: > > - πŸ”Œ [TikTok Intelligence MCP Server](https://apify.com/church_of_loujess/tiktok-intelligence-mcp): call `spy_tiktok_brand_sponsors` directly inside Claude Desktop, ChatGPT, or Cursor > - πŸ“§ [TikTok Influencer & Shop Affiliate Email Finder](https://apify.com/church_of_loujess/tiktok-influencer-email-finder): find niche creators to pair with discovered brand sponsors > - 🎣 [TikTok Viral Hook & Script Scraper](https://apify.com/church_of_loujess/tiktok-viral-hook-script-scraper): dissect the exact 3.5-second spoken hook used inside top-performing `#ad` videos > - 🌐 [Website Email, Phone & Tech Stack Finder](https://apify.com/church_of_loujess/website-email-phone-finder): enrich `brandWebsite` with DNS/MX mail host & 50+ ecommerce tech stack signals ### How much will TikTok Brand Sponsor & Partnership Spy cost? TikTok Brand Sponsor & Partnership Spy uses a transparent **Pay-Per-Event (PPE)** pricing model, where you pay a tiny `$0.05` **Actor Start** event plus a per-item fee for each **Active TikTok Brand Advertiser & Sponsored Campaign Lead**. On the Apify Free plan (`$5.00` monthly free credit included), it costs **$0.04 per item ($40.00 per 1,000 results)** β€” letting you extract up to **123 results every month for free**. Paid Apify plans automatically unlock volume discounts up to **62% off** ($0.024 on Starter/Bronze, $0.019 on Scale/Silver, and **$0.015** on Business/Gold, Platinum & Diamond) with zero residential proxy surcharges: | Apify Plan / Tier | Price per extracted dataset item | Price per 1,000 results | Included Monthly Credit | Approx. Monthly Capacity | | :--- | :--- | :--- | :--- | :--- | | **Free (`FREE`)** | `$0.04` | `$40.00` | `$5.00 / mo` | **~123** results | | **Starter (`BRONZE`)** | `$0.024` | `$24.00` | `$29.00 / mo` | **~1,206** results | | **Scale (`SILVER`)** | `$0.019` | `$19.00` | `$199.00 / mo` | **~10,471** results | | **Business (`GOLD`)** | `$0.015` | `$15.00` | `$999.00 / mo` | **~66,596** results | | **Enterprise (`PLATINUM` / `DIAMOND`)** | `$0.015` / `$0.015` | `$15.00` | Custom | Custom high-volume SLA | > **Cost-control tip:** Batch multiple URLs, handles, or keywords into a single run so the `$0.05` `Actor Start` event is amortized once across your entire batch. You can also set a hard **Maximum cost per run** cap directly in Apify Console. Check the [pricing tab](https://apify.com/church_of_loujess/tiktok-brand-sponsor-spy/pricing) for full details. ### How do I use TikTok Brand Sponsor & Partnership Spy? TikTok Brand Sponsor & Partnership Spy was designed to be effortless to start with β€” even if you have never configured proxies, cookies, or web scrapers before. Here is how to extract data in under a minute: 1. [Create](https://console.apify.com/sign-up) a free Apify account using your email (includes `$5.00` in monthly free usage credit). 2. Open **[TikTok Brand Sponsor & Partnership Spy](https://console.apify.com/actors/xeHydNOuP9qcvU2g3)** in Apify Console. 3. Configure your target inputs (`keywords`, `maxSponsoredLeads`, `resolveBrandContacts`) in the **Input** tab (use **Bulk edit** to paste lists at once). 4. Adjust your results limit or optional enrichment filters to match your workflow. 5. No proxy setup is required β€” the Actor runs directly in a fast **256 MB** container out of the box. 6. Click **Save & Start** and watch structured records stream into your Dataset in real time. 7. Open the **Storage** tab to inspect your results as a clean table or raw JSON. 8. Download your dataset in **JSON, CSV, Excel (`.xlsx`), or XML**, or connect it directly to **Clay, n8n, Make, Zapier, Google Sheets, or MCP**. ### ⬇️ Input Enter any consumer, DTC, ecommerce, mobile-app, or SaaS niches in **`keywords`** (e.g. `"protein powder"`, `"skincare"`, `"ai app"`, `"meal prep"`, `"vpn"`). #### Mode 1: Active Advertiser & Brand-Deal Lead Generation Discovers active sponsored posts in your target verticals and resolves brand domains + marketing emails. | Input / Configuration | What it returns | | :--- | :--- | | `keywords: ["protein powder", "skincare", "electrolytes"]` | Sponsored DTC campaigns + `@brand` handles + resolved `brandWebsite` & `brandEmails` | **Input JSON example:** ```json { "keywords": [ "protein powder", "skincare", "sleep supplement" ], "maxSponsoredLeads": 25, "resolveBrandContacts": true, "onlyWithBrandOrSponsorSignal": true } ``` #### Mode 2: SaaS, Fintech & AI Mobile-App Sponsorship Spy Uncover software and app advertisers paying tech/productivity/finance creators via promo codes and `#partner` tags. | Input / Configuration | What it returns | | :--- | :--- | | `keywords: ["ai tool", "budgeting app", "language learning app"]` | Active app/SaaS creator sponsorships + campaign view counts | **Input JSON example:** ```json { "keywords": [ "ai tool", "study app", "vpn" ], "maxSponsoredLeads": 20, "resolveBrandContacts": true, "onlyWithBrandOrSponsorSignal": true } ``` #### Complete Input Parameter Reference | Parameter | Type | Default | Required | Description | | :--- | :--- | :--- | :--- | :--- | | `keywords` | `array` | `["protein powder", "skincare"]` | No | Niches to scan for active sponsored TikTok posts and brand partnerships (e.g. 'protein powder', 'skincare', 'ai app'). | | `maxSponsoredLeads` | `integer` | `15` | No | Maximum number of sponsored post / active brand advertiser leads to output. | | `resolveBrandContacts` | `boolean` | `true` | No | Automatically inspect tagged @brand TikTok profiles and crawl external brand websites to extract verified marketing/partnership emails. | | `onlyWithBrandOrSponsorSignal` | `boolean` | `true` | No | Only return posts exhibiting explicit sponsorship disclosures (#ad, #sponsored, #partner), promo codes, @brand mentions, or commerce links. | ### ⬆️ Output and setup All extracted records stream incrementally into your run's **Dataset** under the **Storage** tab in Apify Console. Preview results as a clean interactive table, download in **JSON, JSONL, CSV, Excel (`.xlsx`), XML, or RSS**, or consume items directly via the Apify REST API, Python/Node.js SDKs, or MCP. #### πŸ“¦ Verified dataset output sample ```json { "videoId": "7694316152792583457", "vertical": "skincare", "brandHandleOrName": "@sephorauk", "brandTikTokHandle": "@sephorauk", "brandTikTokProfileUrl": "https://www.tiktok.com/@sephorauk", "brandFollowers": null, "brandWebsite": null, "brandEmails": [], "brandInstagramUrl": null, "sponsorSignals": [ "platform_collab_or_ad_flag", "brand_account_mention" ], "promoCodes": [], "allMentionedHandles": [ "@sephorauk", "@anua_global" ], "creatorUsername": "ea_hrst", "creatorFollowers": 272700, "views": 221600, "likes": 24700, "comments": 165, "shares": 3020, "bookmarks": 5334, "engagementRatePct": 14.99, "captionText": "Ad | Literally the best!βœ¨πŸ’— ANUA is available at @Sephora UK and the Vita C glutathione brightening capsule mist is exclusively at Sephora! Launch supported by @glowstation_official🀍 @anua_global #anua #sephora #kbeauty #PDRN #vitac ", "videoUrl": "https://www.tiktok.com/@ea_hrst/video/7694316152792583457", "uploadedAtIso": "2026-10-08T15:16:27.000Z" } ``` #### Output Field Dictionary | Output Field | Type | Description | | :--- | :--- | :--- | | `videoId / vertical / videoUrl` | `string` | TikTok video ID, scanned vertical keyword, and sponsored post URL. | | `brandHandleOrName / brandTikTokHandle / brandTikTokProfileUrl` | `string \| null` | Primary identified advertiser handle and TikTok profile URL. | | `brandFollowers / brandWebsite` | `int / str \| null` | Brand's TikTok follower count and resolved external website. | | `brandEmails / brandInstagramUrl` | `array / str \| null` | Verified brand contact emails and Instagram URL. | | `sponsorSignals / promoCodes / allMentionedHandles` | `array` | Matched disclosure signals, extracted promo codes, and all `@handles` in caption. | | `creatorUsername / creatorFollowers` | `str / int` | Partnered creator handle and audience size. | | `views / likes / comments / shares / bookmarks / engagementRatePct` | `int / float` | Sponsored post performance telemetry. | | `captionText / uploadedAtIso` | `string` | Full ad caption and ISO-8601 UTC publish date. | ### Notes, tips, and exceptions - **Spot underperforming ads for agency pitches:** A brand paying a `300K`-follower creator where the `#ad` got only `4,200` `views` desperately needs better UGC creative hooks β€” pitch them with exact data! - **Chaining with Website Email & Tech Stack Finder:** Some mega-retailers (`@sephorauk`) don't list a plain bio link on TikTok; pass smaller DTC `allMentionedHandles` (like `@anua_global`) into **[TikTok Profile Scraper](https://apify.com/church_of_loujess/tiktok-profile-scraper)** or their domain into **[Website Email & Tech Stack Finder](https://apify.com/church_of_loujess/website-email-phone-finder)** for deeper enrichment. - **Strict filtering (`onlyWithBrandOrSponsorSignal: true`):** Ensures non-sponsored organic videos are skipped without consuming dataset item charges. ### What can you do with data from TikTok Brand Sponsor & Partnership Spy? TikTok Brand Sponsor & Partnership Spy powers high-ROI automation, lead generation, and AI agent pipelines. Here are four proven step-by-step recipes: #### 🎯 Creator / YouTuber / Newsletter sponsorship outbound Creators and talent managers use this Actor to find brands actively cutting influencer checks this month. **Recipe:** 1. **Scan your content vertical.** Run `keywords` matching your audience (`"home gym"`, `"kbeauty"`, `"productivity"`) with `maxSponsoredLeads: 30`. 2. **Export paying brands (`brandHandleOrName`, `brandWebsite`, `brandEmails`).** Deduplicate by `brandTikTokHandle`. 3. **Send proof-backed pitches.** Reference their active creator campaign (`creatorUsername`) and show how your audience engagement compares. Turns sponsorship outreach from cold guessing into warm budget-verified conversations. #### 🎬 UGC & paid-social creative agency client acquisition Find DTC brands spending on influencer posts whose creatives are flopping (`views < 0.05 * creatorFollowers`). **Recipe:** 1. **Pull 50 sponsored campaigns in a vertical.** Sort exported rows ascending by `views / creatorFollowers`. 2. **Dissect what went wrong.** Compare weak ad hooks against niche winners from **[TikTok Viral Hook & Script Scraper](https://apify.com/church_of_loujess/tiktok-viral-hook-script-scraper)**. 3. **Email the brand's marketing team.** Share 3 custom hook rewrites via `brandEmails`. Automate weekly in Clay + Instantly. #### πŸ•΅οΈ Competitive influencer roster & promo-code intelligence See every creator, affiliate code (`promoCodes`), and product angle your DTC competitors are funding. **Recipe:** 1. **Search competitor brand names & product categories.** Run weekly with `onlyWithBrandOrSponsorSignal: true`. 2. **Track `views` & `engagementRatePct`.** Recruit the exact creators driving the highest ROI in your category once their exclusivity window ends. Pair with **[TikTok Influencer Email Finder](https://apify.com/church_of_loujess/tiktok-influencer-email-finder)** to grab those creators' emails. #### πŸ›οΈ Affiliate SaaS & influencer-platform SDR pipeline Sell influencer-management, affiliate-tracking, or whitelisting software to brands manually running promo-code deals. **Recipe:** 1. **Filter `promoCodes` non-empty.** Brands still tracking ROI via manual caption promo codes (`CODE20`) are prime buyers for automated attribution platforms. Push directly into Salesforce, HubSpot, or Apollo. ### Want to get other B2B, Social, Financial, or MCP Agent data? Chain this tool with our other **128 MB / 256 MB zero-proxy Apify Scrapers and Live Streamable-HTTP MCP Servers**:
πŸ”Œ TikTok Intelligence MCP Server (Claude, ChatGPT, Cursor) πŸ“§ TikTok Influencer, UGC & Shop Affiliate Email Finder
🎣 TikTok Viral Hook & Spoken Script Scraper 🌐 Website Email, Phone, Socials & Tech Stack Finder
πŸ›οΈ Shopify App Reviews & DTC Merchant Leads Scraper πŸ’¬ TikTok Comment Buyer-Intent & Warm Lead Miner
🎡 TikTok Breakout Sound & Velocity Trend Radar πŸ“° Substack Newsletter & Sponsor Leads Scraper
### πŸ”Œ Using TikTok Brand Sponsor & Partnership Spy with the Apify API, SDKs & MCP Automate **TikTok Brand Sponsor & Partnership Spy** programmatically from Python, Node.js/TypeScript, cURL, workflow builders (**n8n, Make, Zapier, Clay, Pipedream**), or **Model Context Protocol (`MCP`)** AI clients. #### Python (`apify-client`) ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("church_of_loujess/tiktok-brand-sponsor-spy").call( run_input={ "keywords": [ "protein powder", "skincare", "sleep supplement" ], "maxSponsoredLeads": 25, "resolveBrandContacts": True, "onlyWithBrandOrSponsorSignal": True } ) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` #### Node.js / TypeScript (`apify-client`) ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: '' }); const run = await client.actor('church_of_loujess/tiktok-brand-sponsor-spy').call({ "keywords": [ "protein powder", "skincare", "sleep supplement" ], "maxSponsoredLeads": 25, "resolveBrandContacts": true, "onlyWithBrandOrSponsorSignal": true }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Extracted ${items.length} items:`, items); ``` #### One-Line Synchronous REST API (`cURL` β€” ideal for n8n, Make & Clay HTTP Columns) ```bash curl -X POST "https://api.apify.com/v2/acts/church_of_loujess~tiktok-brand-sponsor-spy/run-sync-get-dataset-items?token=" \ -H "Content-Type: application/json" \ -d '{"keywords": ["protein powder", "skincare", "sleep supplement"], "maxSponsoredLeads": 25, "resolveBrandContacts": true, "onlyWithBrandOrSponsorSignal": true}' ``` #### Claude Desktop, Cursor, Windsurf & OpenAI MCP Configuration ```json { "mcpServers": { "apify-tiktok-brand-sponsor-spy": { "url": "https://mcp.apify.com/?actors=church_of_loujess/tiktok-brand-sponsor-spy", "headers": { "Authorization": "Bearer " } } } } ``` ### ❓ Frequently Asked Questions #### What sponsorship signals does this Actor detect? Explicit disclosure tags (`#ad`, `#sponsored`, `#partner`, `#gifted`, `#paidpartnership`, `Ad |`), TikTok platform collaboration/branded-content flags, discount promo-code patterns (`use code ...`), and tagged `@brand` corporate accounts. #### How does `resolveBrandContacts` find the brand's website and email? When a sponsored post tags `@brand`, the Actor inspects `@brand`'s TikTok profile to extract its `bioLink` / website (`brandWebsite`) and crawls the brand's homepage and contact pages to extract verified `brandEmails` and `brandInstagramUrl`. #### Am I charged for non-sponsored organic TikToks? No β€” when `onlyWithBrandOrSponsorSignal: true` (default), organic videos without sponsorship/brand signals are filtered out before writing to the dataset. #### Can it spot multiple brands co-sponsoring the same post? Yes! While `brandHandleOrName` highlights the primary tagged brand, `allMentionedHandles[]` preserves every `@handle` mentioned in the campaign (for example, `@sephorauk` + `@anua_global` + PR agency `@glowstation_official`). #### Does it work for B2B SaaS and mobile apps as well as DTC physical products? Yes β€” search category phrases like `"ai meeting notes"`, `"coding tool"`, `"investing app"`, or `"vpn"`. #### Do I need proxies or a TikTok account? No. It runs cleanly inside `256 MB` RAM with zero login credentials and zero proxy fees. #### Is it legal to extract public data with TikTok Brand Sponsor & Partnership Spy? TikTok Brand Sponsor & Partnership Spy only accesses **publicly available web pages, feeds, and registries** that require no private account login or authentication bypass. Keep in mind that extracted contact fields (such as public business emails, names, or usernames) can still qualify as personal data under frameworks like the [GDPR](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation) or CCPA depending on jurisdiction. Always ensure you have a lawful basis (such as legitimate B2B interest) and consult Apify's guide on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). #### Can I integrate TikTok Brand Sponsor & Partnership Spy with Clay, n8n, Make, Zapier, or Google Sheets? Yes. Every run outputs clean, flat-friendly fields alongside nested detail objects and integrates natively with **Clay, n8n, Make, Zapier, Slack, HubSpot, Airtable, Google Sheets, Airbyte, LangChain, and CrewAI** via [Apify Integrations](https://apify.com/integrations). You can also attach [webhooks](https://docs.apify.com/integrations/webhooks) to trigger downstream workflows automatically the instant a run succeeds. #### Can I call TikTok Brand Sponsor & Partnership Spy programmatically via the Apify API? Yes. Use the official `apify-client` [Python package](https://apify.com/church_of_loujess/tiktok-brand-sponsor-spy/api/python) or [Node.js NPM package](https://apify.com/church_of_loujess/tiktok-brand-sponsor-spy/api/javascript), or call the synchronous `/run-sync-get-dataset-items` REST endpoint directly. Full specifications are in the [Apify API v2 reference](https://docs.apify.com/api/v2). #### TikTok Brand Sponsor & Partnership Spy not working or need a custom feature? We actively maintain and monitor all 26 Actors and MCP Servers in our portfolio. If you encounter an edge case, unexpected output, or want to request a new field, please open a ticket on the Actor's [Issues tab](https://apify.com/church_of_loujess/tiktok-brand-sponsor-spy/issues/open) with your Run ID so we can resolve it rapidly. # Actor input Schema ## `keywords` (type: `array`): Niches to scan for active sponsored TikTok posts and brand partnerships (e.g. 'protein powder', 'skincare', 'ai app'). ## `maxSponsoredLeads` (type: `integer`): Maximum number of sponsored post / active brand advertiser leads to output. ## `resolveBrandContacts` (type: `boolean`): Automatically inspect tagged @brand TikTok profiles and crawl external brand websites to extract verified marketing/partnership emails. ## `onlyWithBrandOrSponsorSignal` (type: `boolean`): Only return posts exhibiting explicit sponsorship disclosures (#ad, #sponsored, #partner), promo codes, @brand mentions, or commerce links. ## Actor input object example ```json { "keywords": [ "protein powder", "skincare" ], "maxSponsoredLeads": 15, "resolveBrandContacts": true, "onlyWithBrandOrSponsorSignal": true } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "protein powder", "skincare" ] }; // Run the Actor and wait for it to finish const run = await client.actor("church_of_loujess/tiktok-brand-sponsor-spy").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": [ "protein powder", "skincare", ] } # Run the Actor and wait for it to finish run = client.actor("church_of_loujess/tiktok-brand-sponsor-spy").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "protein powder", "skincare" ] }' | apify call church_of_loujess/tiktok-brand-sponsor-spy --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,church_of_loujess/tiktok-brand-sponsor-spy" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/xeHydNOuP9qcvU2g3/builds/ZQ0TqEkA9Ygb7QIph/openapi.json