# Instagram Brand Collaboration & Influencer Analyzer (`atlasi/instagram-influencer-brand-collab-analyzer`) Actor

Analyze public Instagram profiles and official Meta branded-content collaborations with transparent engagement metrics.

- **URL**: https://apify.com/atlasi/instagram-influencer-brand-collab-analyzer.md
- **Developed by:** [Atlas](https://apify.com/atlasi) (community)
- **Categories:** Social media, Marketing, Lead generation
- **Stats:** 2 total users, 1 monthly users, 20.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 profile analyses

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![Actor status](https://apify.com/actor-badge?actor=atlasi/instagram-influencer-brand-collab-analyzer)](https://apify.com/atlasi/instagram-influencer-brand-collab-analyzer)

### What does this Instagram influencer analyzer do?

Enter an Instagram username to get public profile metrics, official Meta brand-collaboration evidence, and sponsored-versus-recent content performance in one structured result.

Use it to vet creators before sponsorships, research a brand's creator partnerships, compare campaign performance, or monitor competitors. Unlike tools that treat every mention or `#ad` as a confirmed sponsorship, collaboration records come from Meta's branded-content library and include the available evidence URL.

### What data can you extract?

- Public profile details: biography, followers, following, post count, verification, category, and external URL.
- Official collaboration dates, content types, creators, brand partners, and evidence URLs.
- Median recent interaction rate, calculated as `(likes + comments) / followers`.
- Separate recent post and Reel interaction-rate medians.
- Optional likes, comments, and views for collaboration posts and Reels.
- Collaboration-versus-recent performance multiplier for creator accounts.
- Coverage and warning fields explaining missing or partial data.

Views are reported separately and are never added to likes and comments as engagement. For brand inputs, creator interaction rates are omitted because the brand's follower count is not a valid denominator.

### Quick start

1. Add one to five public Instagram usernames or profile URLs.
2. Keep the collaboration limit low for the first run. Enable content metrics only when you need post-level performance.
3. Click **Start**, then open the Dataset tab to view or export one result per input profile.

Example input:

```json
{
  "usernames": ["ayodifamily"],
  "lookbackDays": 90,
  "maxCollaborationsPerProfile": 1,
  "includeContentMetrics": true
}
```

### Example output

Shortened example captured from a public collaboration record on September 3, 2026:

```json
{
  "inputUsername": "ayodifamily",
  "status": "ok",
  "direction": "creator",
  "profileUrl": "https://www.instagram.com/ayodifamily/",
  "collaborationCount": 1,
  "uniquePartnerCount": 1,
  "collaborationMetricCoveragePct": 100,
  "medianRecentInteractionRatePct": 0.7469,
  "medianCollaborationInteractionRatePct": 0.0732,
  "collaborationVsRecentMultiplier": 0.098,
  "partnerUsernames": ["nike"],
  "collaborations": [
    {
      "publishedAt": "2026-09-02",
      "contentType": "reel",
      "url": "https://www.instagram.com/reel/DcyoDgVsho8/",
      "partnerUsernames": ["nike"],
      "likesCount": 231,
      "commentsCount": 5,
      "viewsCount": 6937,
      "interactionRatePct": 0.0732,
      "source": "meta_branded_content_library"
    }
  ],
  "warnings": []
}
```

The full output also includes profile fields, recent-content baselines, optional content metrics, coverage, and warning fields.

#### Result statuses

| Status | Meaning |
| --- | --- |
| `ok` | Profile and collaboration lookups completed. |
| `partial` | Useful data was saved, but an upstream lookup or optional enrichment failed. |
| `profile_not_found` | The public profile could not be found. |
| `failed` | Both required data paths failed for that input. |

Unknown values are returned as `null`. A collaboration count of `0` means the lookup completed and no official records were found; `null` means the collaboration lookup failed.

### Input options

| Field | Default | Description |
| --- | ---: | --- |
| `usernames` | required | One to five public usernames, `@handles`, or Instagram profile URLs. |
| `lookbackDays` | `90` | Official collaboration history window, from 1 to 365 days. |
| `maxCollaborationsPerProfile` | `3` | Maximum collaboration records per input, from 1 to 50. |
| `includeContentMetrics` | `false` | Enrich collaboration posts and Reels with public metrics. Starts additional paid Actor runs. |

Duplicate usernames are analyzed once. One failed input does not discard successful results for the others.

### How much does it cost?

This Actor currently uses **pay per usage** while pay-per-event activation is pending. There is no additional developer fee; you pay Apify platform usage and the current charges of the upstream Actors used by the run.

Recent validation on September 3, 2026 observed approximately `$0.003` for a profile with no collaboration, `$0.009–$0.015` for one or two collaborations, and `$0.013` for one enriched Reel. Actual cost depends on returned results, your Apify plan, and upstream pricing.

### How it works

The Actor combines maintained Apify Store Actors and normalizes their results:

1. [Instagram Profile Scraper](https://apify.com/apify/instagram-profile-scraper) retrieves public profile details and recent content.
2. [Meta Brand Collaboration Scraper](https://apify.com/apify/brand-collaboration-scraper) retrieves official branded-content records.
3. When requested, Instagram Post and Reel Scrapers enrich evidence URLs with public metrics.
4. This Actor deduplicates records, calculates transparent metrics, and writes one comparison-ready dataset row per input.

### Run through the API

```bash
curl -X POST \
  "https://api.apify.com/v2/acts/atlasi~instagram-influencer-brand-collab-analyzer/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["ayodifamily"],"lookbackDays":90,"maxCollaborationsPerProfile":1}'
```

The Actor is also available through the automatically generated JavaScript, Python, CLI, OpenAPI, HTTP, and MCP integrations in the **API** tab.

### Limitations

- Only public Instagram profiles are supported.
- No result does not prove that an account has never received sponsorships; it means no record was found in Meta's branded-content library for the requested window.
- Deleted content, private profiles, hidden metrics, changed usernames, and upstream platform changes can produce partial records.
- The recent baseline is based on the recent content sample returned by the profile scraper.
- Official collaborations found in the current run are removed from the recent baseline, but undisclosed sponsorships may remain.
- This Actor does not collect emails, private content, audience demographics, or authenticity scores.

Use the data only for lawful purposes and follow the privacy, advertising-disclosure, Instagram, Meta, and Apify requirements applicable to your use case.

### FAQ and support

#### Does this require an Instagram login?

No. It works with public data and does not require Instagram credentials or cookies.

#### Why are likes, comments, or views null?

Content enrichment is disabled by default. Even when enabled, deleted content, Stories, or hidden metrics may not expose these values. Check `collaborationMetricCoveragePct` and `warnings` before comparing results.

#### Why is the account role unknown?

`direction` is inferred from the official collaboration records returned in the requested window. It remains `unknown` when there is not enough evidence to classify the account as a creator or brand.

#### How do I report a problem?

Open the Actor's [Issues tab](https://console.apify.com/actors/HcFO74MF9CFRjpdCx/issues) and include the run ID, input settings, and expected result. Do not include your API token.

# Actor input Schema

## `usernames` (type: `array`):

Public Instagram usernames such as nike, @nike, or https://www.instagram.com/nike/.

## `lookbackDays` (type: `integer`):

How many days of official branded-content history to request.

## `maxCollaborationsPerProfile` (type: `integer`):

Hard limit per input profile. Lower values finish faster and cost less.

## `includeContentMetrics` (type: `boolean`):

Fetch likes, comments, and views for each collaboration URL. This starts additional paid Actor runs.

## Actor input object example

```json
{
  "usernames": [
    "ayodifamily"
  ],
  "lookbackDays": 90,
  "maxCollaborationsPerProfile": 3,
  "includeContentMetrics": false
}
```

# Actor output Schema

## `results` (type: `string`):

One normalized analysis record for each requested Instagram profile.

## `summary` (type: `string`):

Run totals, selected options, and the upstream Actors used.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "usernames": [
        "ayodifamily"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("atlasi/instagram-influencer-brand-collab-analyzer").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "usernames": ["ayodifamily"] }

# Run the Actor and wait for it to finish
run = client.actor("atlasi/instagram-influencer-brand-collab-analyzer").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 '{
  "usernames": [
    "ayodifamily"
  ]
}' |
apify call atlasi/instagram-influencer-brand-collab-analyzer --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,atlasi/instagram-influencer-brand-collab-analyzer"
        }
    }
}

```

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 <APIFY_API_TOKEN>` 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/HcFO74MF9CFRjpdCx/builds/Iu34r4w5cDQv9VUN4/openapi.json