Social Profile Aggregator

Extract social media profiles across Instagram, TikTok, X/Twitter, and LinkedIn with a single API call and a unified schema. Built by Tropical Tools — structured data extraction APIs optimized for AI agents.

Stop juggling four different scrapers. The Social Profile Aggregator is a unified social media scraper that returns consistent, structured profile data from Instagram, TikTok, X/Twitter, and LinkedIn. Pass in a username or profile URL, and get back a normalized JSON object with follower counts, bios, verification status, and platform-specific fields — all in one response.

Why Use This Actor?

• Unified schema across 4 platforms — Every profile maps to the same displayName, bio, followerCount, followingCount, profileImageUrl, and isVerified fields, regardless of source platform. No more writing transformation logic per platform.
• Auto-detect platform from URL — Pass https://instagram.com/natgeo or https://tiktok.com/@charlidamelio and the actor identifies the platform automatically. No need to specify which social media scraper to use.
• Batch processing — Send an array of 50+ profiles in a single run. Mixed platforms, mixed formats (URLs and usernames) — all handled in one request.
• API-first extraction — Clean JSON or Markdown output designed for programmatic consumption. Minimal nesting (max 3 levels), typed fields, and machine-readable metadata.
• MCP-compatible — Includes _tropicalTools metadata in every response. Ready for AI agent orchestration pipelines and tool-use frameworks.
• Per-platform success/failure reporting — Know exactly which platforms succeeded and which failed for each profile, with detailed error messages.

Supported Platforms

Instagram Profile Scraper

Extracts: followerCount, followingCount, postCount, biography, fullName, profilePicUrl, isVerified, externalUrl, category

TikTok Scraper

Extracts: followerCount, followingCount, videoCount, likesCount, nickname, signature (bio), profilePicUrl, isVerified

Twitter / X Scraper

Extracts: followerCount, followingCount, tweetCount, displayName, bio, profileImageUrl, isVerified, location, website, joinedDate

LinkedIn Scraper

Extracts: displayName, headline, summary, connectionCount, profileImageUrl, currentPosition, company, location

Input Configuration

Field	Type	Required	Description
profiles	string[]	Yes	List of usernames or profile URLs. Auto-detects platform from URLs.
platforms	string[]	No	Filter to specific platforms: instagram, tiktok, twitter, linkedin. Defaults to all.
outputFormat	string	No	json (default) or markdown for LLM consumption.

Output Example

A TikTok profile extraction returns both unified and platform-specific fields:

{
    "input": "https://www.tiktok.com/@charlidamelio",
    "detectedPlatform": "tiktok",
    "unified": {
        "displayName": "Charli D'Amelio",
        "bio": "don't you dare",
        "followerCount": 155200000,
        "followingCount": 1423,
        "profileImageUrl": "https://p16-sign-sg.tiktokcdn.com/...",
        "isVerified": true,
        "postCount": 2470
    },
    "platforms": {
        "tiktok": {
            "username": "charlidamelio",
            "nickname": "Charli D'Amelio",
            "signature": "don't you dare",
            "followerCount": 155200000,
            "followingCount": 1423,
            "videoCount": 2470,
            "likesCount": 11600000000,
            "profilePicUrl": "https://p16-sign-sg.tiktokcdn.com/...",
            "isVerified": true
        },
        "instagram": null,
        "twitter": null,
        "linkedin": null
    },
    "platformsSucceeded": ["tiktok"],
    "platformsFailed": [],
    "_tropicalTools": {
        "actorName": "social-profile-aggregator",
        "actorVersion": "0.1",
        "extractedAt": "2026-03-20T12:00:00.000Z",
        "processingTimeMs": 3420
    }
}

Cost Estimation

This actor uses pay-per-event pricing at $0.005 per profile extracted. You are only charged for successful extractions. A batch of 100 profiles costs $0.50. Failed extractions (private profiles, non-existent users) are not charged.

Use Cases

• Influencer research — Pull follower counts, engagement metrics, and bios across platforms for a list of influencer candidates.
• People research agents — AI agents doing background research on individuals can get unified social data in a single tool call.
• Talent scouting — Quickly compare a candidate's social presence across Instagram, TikTok, X, and LinkedIn.
• Brand monitoring — Track competitor or brand social profiles across platforms with consistent data formatting.
• Competitive analysis — Compare social media presence across platforms for market research.
• CRM enrichment — Augment contact records with social profile data from multiple platforms.

FAQ

What happens with private profiles? Private or restricted profiles return a clear status in the platformsFailed array with an error message. You are not charged for failed extractions. The actor never attempts to access private or protected content.

How does the actor handle rate limiting? The actor includes built-in retry logic with appropriate backoff for each platform. If a platform rate-limits a request, the actor retries with exponential delay. Persistent rate limiting is reported as a platform failure.

How accurate is the extracted data? Data is extracted directly from public profile pages. Follower counts, bios, and verification status reflect what is publicly visible at extraction time. Counts may differ slightly from in-app numbers due to platform rounding.

Which platforms support auto-detection from URLs? All four platforms: Instagram (instagram.com), TikTok (tiktok.com), X/Twitter (twitter.com, x.com), and LinkedIn (linkedin.com/in/). When you pass a plain username without a URL, specify the platforms field or the actor checks all platforms.

How fresh is the data? Every run extracts data in real-time from public profile pages. There is no caching — you always get current data at the time of extraction.

Can I extract multiple profiles in one run? Yes. Pass an array of up to 50+ profiles in the profiles field. They can be a mix of URLs and usernames across different platforms. Results include per-profile success/failure reporting.

What output formats are available? JSON (default) returns structured data with unified and platform-specific fields. Markdown returns a human/LLM-readable summary optimized for consumption by language models and AI agents.