Overview

Get an introduction to SocialDataKit, the data you can access, and how to make your first API request.

Introduction

SocialDataKit brings public social media data into your application. Request profiles, posts, videos and transcripts with one API key, and get a consistent JSON response.

What you can build

Find creators, research content, follow public engagement and enrich your own products with data from Instagram, TikTok and YouTube.

Platform	Public data	Reference
Instagram	Profiles, posts and reels	View endpoints
TikTok	Profiles, videos and comments	View endpoints
YouTube	Videos, channels and transcripts	View endpoints
Meta Ads Preview	Facebook and Instagram ad creatives	View preview

Availability varies by endpoint. Preview routes need evaluation for your use case. Meta Ads live collection is currently disabled; development samples are free. Check API status before relying on live data.

Making your first request

Create your account

Get started with 100 free credits. No credit card is required.

Create an API key

Open API keys in your dashboard. Use a development key for samples or a production key for live requests.

Request public data

Choose an endpoint and send your key in the x-api-key header. Start with a public TikTok profile:

Request

curl 'https://api.socialdatakit.com/v1/tiktok/profile?handle=tiktok' \
  -H 'x-api-key: YOUR_API_KEY'

Understanding your response

Your result is inside data. Request details, caching and credit charges are inside meta. Fields the source does not provide are null.

Response structure

{
  "data": {
    "profile": {
      "username": "tiktok",
      "followers": null
    }
  },
  "meta": {
    "cached": false,
    "credits_charged": 0,
    "sandbox": true
  }
}

Credits and caching

Successful fresh live requests use the credit cost shown on each endpoint. Errors, development samples and cached responses are free. Purchased credits do not expire.

Accept a recent result with cache_max_age, or leave it out to request fresh data. Learn about credits and cached results.

Where to go next

Follow the quickstart, browse the API reference, or explore a free interactive example. For recurring reporting workflows, see Tracking & reports and Campaign reporting. For AI agents and tools, see the CLI and MCP guide.