# EnsembleData

> EnsembleData provides real-time social media data scraping APIs for TikTok, Instagram, YouTube, Threads, Reddit, Twitch, Twitter (X), and Snapchat — used by influencer marketing platforms, creator agencies, and social listening companies for profile, post, comment, hashtag, and analytics data extraction at scale.

## Overview

EnsembleData is a unified API for social media scraping, data mining, and analytics, in operation since 2020. It offers real-time, robust, and scalable endpoints to extract posts, profiles, comments, hashtags, and engagement metrics from major social platforms without requiring account credentials or login access — all data comes from publicly available sources.

Key stats: 35M+ average daily requests, under 3 seconds average response time, 99.7% success rate.

Clients include companies such as Volvo, Shein, Warner, UMG, Klook, and Garena, spanning influencer marketing platforms, content creator agencies, and social listening companies.

## Why EnsembleData

- **Real-time & bulk data**: Live extraction of video metadata, profile analytics, hashtags, and engagement — not cached data.
- **Robustness & compliance**: GDPR-compliant infrastructure, no downtime, privacy-focused.
- **Scalability & automation**: Handles millions of requests per day; suited for AI training data, trend analysis, and business intelligence.
- **No authentication needed**: No account credentials required to access public data.
- **Multi-platform SDKs**: REST endpoints plus official SDKs for Python and JavaScript.
- **Enterprise support**: Help with integration, compliance, and custom data pipelines.

## Platforms & Endpoints

### TikTok
- User Profile Information — bio, follower counts, engagement stats
- Posts — video data from any public account
- Post Information — views, shares, hashtags, engagement
- Comments — at-scale comment extraction
- Music — trending sounds and usage counts
- Search by Keyword
- Search by Hashtag
- Followers
- Followings

### Instagram
- User Profile Information
- Posts
- Post Information — engagement metrics, comments
- Comments
- Music — trending audio tracks
- Search by Keyword
- Reels — views, play rates, audio, engagement
- Tagged Posts

### YouTube
- Channel Profile Information — subscribers, views, upload frequency
- Videos — full channel video catalog
- Shorts — performance data
- Streams — live stream data, concurrent viewers, chat volume
- Comments
- Music Posts — music IDs linked to Shorts
- Search by Keyword
- Search by Hashtag

### Threads
- Posts by Keyword
- User Search
- User Profile Information
- Posts
- Post Information and Replies

### Reddit
- Search by Keyword
- Search on Subreddit — top/new/hot feeds
- Comments — nested threads, upvotes, author data

### Twitch
- Search by Keyword — live/recent streams, trending games
- User Followers — follower lists, growth metrics

### Twitter (X)
- User Profile Information
- Posts — tweet history
- Post Information — likes, retweets, quotes, replies, impressions

### Snapchat
- User Profile Information — follower counts, engagement, bio

## Use Cases

- Brand performance monitoring
- Competitor intelligence analysis
- Marketing campaign performance insights
- Social sentiment analytics
- Consumer behavior insights
- Audience demographic analysis
- Cross-platform campaign tracking
- Market data intelligence
- Hashtag popularity & trend analysis
- Influencer discovery and vetting
- Academic and market research, including AI/ML dataset creation

## FAQ

**Who is the API for?** Developers, hedge funds, marketers, researchers, agencies, and brands needing social media insights for trend analysis, brand monitoring, influencer discovery, competitor analysis, and research.

**Which platforms are supported?** Twitch, X (Twitter), YouTube, Reddit, TikTok, Instagram, Snapchat, and Threads.

**What data can be fetched?** User profiles, posts, video metadata, comments, replies, engagement metrics, hashtags, keywords, and brand mentions — all returned as structured JSON.

**Is data real-time or cached?** Real-time; data is fetched live from the source platform at the time of the API call.

**Are login credentials required?** No — only publicly available data is accessed, with no risk to personal accounts.

**Can it handle scale without rate limits?** Yes — EnsembleData manages rotating proxies, retries, and session handling internally, supporting millions of requests per day.

**Is historical data available?** Yes for most platforms and endpoint types, with pagination going back months or years; depth varies by platform and endpoint.

## Pricing

Plans are billed monthly in USD and metered by a daily "unit" allowance that resets at 00:00 UTC (unused units do not roll over). All tiers include access to every platform (TikTok, Instagram, YouTube, Threads, Reddit, Twitch, Twitter, Snapchat) — plans differ only in daily unit volume.

| Plan | Units / day | Price / month |
| --- | --- | --- |
| Free Trial | 50 | $0 |
| Wood | 1,500 | $100 |
| Bronze | 5,000 | $200 |
| Silver | 11,000 | $400 |
| Gold | 25,000 | $800 |
| Platinum | 50,000 | $1,400 |
| Diamond | Custom | Contact sales |

**What is a unit?** Units are EnsembleData's internal pricing mechanism per endpoint call — simple calls (e.g. basic user info, a page of posts, a page of comments) typically cost 1 unit, while calls returning more data (e.g. detailed user info with recent posts, follower lists) cost more, up to around 10 units per call. Failed requests caused by internal errors are not charged. Exact per-endpoint unit costs are listed in the API documentation.

**Pricing FAQ highlights:**
- No units are charged for failures caused by internal errors.
- Payments are processed via Stripe (card or bank transfer).
- Daily units reset at 00:00 UTC.
- Only public data is scraped — no private/sensitive data, no fake accounts, GDPR- and platform-ToS-compliant.
- Data returns as JSON, suitable for direct integration into ETL pipelines, data warehouses (BigQuery, Snowflake), or analytics dashboards.
- SLAs are available for enterprise-scale use.

## Scraping Guide

The [EnsembleData Guide](https://ensembledata.com/guide) is a step-by-step walkthrough organized by platform (TikTok, Instagram, YouTube, Threads, Reddit, Twitch, Twitter, Snapchat) and, within each platform, by task (e.g. monitoring hashtags, monitoring keywords, fetching user info, fetching followers). Each guide page typically includes:
- A description of the endpoint and what data it returns
- A minimal working code sample (Python via `requests`, Python via the official SDK, and JavaScript)
- Notes on pagination (e.g. `cursor` parameters) and rate/timeout considerations for heavier endpoints (e.g. "full" search endpoints that aggregate many results in one call and may need longer client-side timeouts)
- Links to the matching API Documentation entry and a sample response

Example (TikTok Keyword Search): a single call to `https://ensembledata.com/apis/tt/keyword/search` with `name`, `period` (0/1/7/30/90/180 days), and `token` parameters returns matching posts and a `nextCursor` for pagination. A "Full" variant of the same search aggregates multiple internal requests into one call and can take several minutes to respond, so a longer client timeout (10+ minutes) is recommended for raw HTTP use; the official SDKs handle this automatically.

## Getting Started

1. Sign up for a free EnsembleData dashboard account (no credit card required) to get an API token — this also enrolls you in the Free Trial tier (50 units/day).
2. Verify your email address; requests won't return data until this is done.
3. Use the token with REST endpoints directly, or via the official Python or JavaScript SDK.
4. Consult the [API documentation](https://ensembledata.com/apis/docs) for endpoint-specific parameters, or the [scraping guide](https://ensembledata.com/guide) for task-based walkthroughs with code samples.
5. Upgrade to a paid plan (Wood through Platinum, or a custom Diamond plan) as usage scales past the free daily unit allowance.

## Docs
- [API Documentation](https://ensembledata.com/apis/docs): Full endpoint reference, parameters, and unit costs.
- [Scraping Guide](https://ensembledata.com/guide): Task-based walkthroughs with code samples, organized by platform.
- [Pricing](https://ensembledata.com/pricing): Plan tiers, unit system, and billing FAQ.
- [API Status](https://ensembledata.com/status): Live uptime and incident status.

## SDKs
- [Python SDK](https://github.com/ensembledata/ensembledata-python)
- [Node.js SDK](https://github.com/ensembledata/ensembledata-node)

## Optional
- [Blog](https://ensembledata.com/blog)
- [Contact](https://ensembledata.com/contact)
- [Terms & Conditions](https://ensembledata.com/terms-and-conditions)