Skip to main content

​
Clay Integration API

A unified API for fetching and enriching social media data from multiple platforms.

​
Supported Platforms

PlatformEndpoints
TikTokPosts, Comments, Bulk Posts, Hashtag Search
InstagramPosts, Comments, Hashtag Search
YouTubeSearch, Comments, Hashtag Search, Channel Videos, Channel Shorts
RedditSubreddit Posts, Post Comments

​
Key Features

Multi-Platform

Access TikTok, Instagram, YouTube, and Reddit through a single API

ML Enrichment

Analyze content with sentiment, topics, intent, and keyword extraction

Credit-Based Pricing

Transparent per-request credit consumption

Pagination

Efficiently handle large datasets with cursor-based pagination

​
Authentication

All API requests require an API key in the X-API-Key header: 
curl -X POST "https://api.yourservice.com/tiktok/posts" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"username": "charlidamelio", "limit": 10}'

​
ML Enrichment Options

Add AI-powered analysis to any content endpoint:
  • sentiment - Positive, negative, or neutral classification
  • topics - Extract main topics from content
  • intent - Identify user intent (purchase, complaint, question, etc.)
  • keywords - Extract important keywords and phrases
{
  "username": "charlidamelio",
  "limit": 10,
  "enrich": ["sentiment", "topics", "intent", "keywords"]
}

​
Response Format

All endpoints return a consistent response structure: 
{
  "success": true,
  "data": { ... },
  "metadata": {
    "credits_used": 15,
    "processing_time": 1.234,
    "enrichments_applied": ["sentiment", "topics"]
  }
}

​
Getting Started

  1. Get your API key
  2. Make your first request to any endpoint
  3. Add ML enrichment as needed
  4. Use pagination for large datasets
Explore the API Reference below to see all available endpoints.