---
name: creatorcrawl
description: Access live TikTok and Instagram data via the CreatorCrawl API. Look up creator profiles, search videos, pull comments and transcripts, track trending hashtags, discover popular songs, scrape Instagram reels and posts. Use whenever someone asks about TikTok creators, Instagram profiles, videos, trends, or social media research.
version: 1.0.0
user-invocable: true
metadata: {"openclaw":{"requires":{"env":["CREATORCRAWL_API_KEY"],"bins":["curl"]},"primaryEnv":"CREATORCRAWL_API_KEY","emoji":"📱","homepage":"https://creatorcrawl.com"}}
---

# CreatorCrawl TikTok & Instagram Data

Access live TikTok and Instagram data: creator profiles, video analytics, comments, transcripts, search, trending content, songs, reels, and story highlights. 30+ endpoints, structured JSON responses, no scraping required.

## Setup

Get a free API key at https://creatorcrawl.com (250 free credits, no card required). Set the `CREATORCRAWL_API_KEY` environment variable.

## How to call the API

Use curl for all requests. Authenticate with the `x-api-key` header. Base URL: `https://creatorcrawl.com`.

```bash
curl -s -H "x-api-key: $CREATORCRAWL_API_KEY" \
  "https://creatorcrawl.com/api/tiktok/profile?handle=charlidamelio"
```

All responses are JSON. Errors return `{ "success": false, "error": "message" }` with status 400 (bad params), 401 (unauthorized), 402 (no credits), or 502 (upstream).

## Endpoints

### Profiles

**GET /api/tiktok/profile** — Get a creator's profile, stats, and recent videos.
| Param | Required | Description |
|-------|----------|-------------|
| handle | yes | TikTok handle (without @) |

Returns: user info (id, uniqueId, nickname, signature, verified), stats (followerCount, followingCount, heartCount, videoCount), and recent videos.

**GET /api/tiktok/profile/videos** — Get a creator's videos with pagination and sorting.
| Param | Required | Description |
|-------|----------|-------------|
| handle | yes | TikTok handle |
| sort_by | no | `latest` or `popular` |
| max_cursor | no | Pagination cursor from previous response |
| region | no | 2-letter country code |

Returns: aweme_list with statistics (play_count, digg_count, comment_count, share_count), author info, music info. Paginate with `max_cursor`.

**GET /api/tiktok/user/followers** — Get a creator's followers (paginated).
| Param | Required | Description |
|-------|----------|-------------|
| handle | yes (or user_id) | TikTok handle |
| user_id | yes (or handle) | User ID (faster) |
| min_time | no | Pagination cursor |

**GET /api/tiktok/user/following** — Get accounts a creator follows.
| Param | Required | Description |
|-------|----------|-------------|
| handle | yes | TikTok handle |
| min_time | no | Pagination cursor |

**GET /api/tiktok/user/live** — Check if a creator is live streaming.
| Param | Required | Description |
|-------|----------|-------------|
| handle | yes | TikTok handle |

### Videos

**GET /api/tiktok/video** — Get full video details.
| Param | Required | Description |
|-------|----------|-------------|
| url | yes | TikTok video URL |
| get_transcript | no | `true` to include transcript |
| region | no | 2-letter country code |

Returns: aweme_detail with statistics, author, music, video dimensions, hashtags, and optional transcript.

**GET /api/tiktok/video/comments** — Get video comments (paginated).
| Param | Required | Description |
|-------|----------|-------------|
| url | yes | TikTok video URL |
| cursor | no | Pagination cursor |

Returns: comments with text, digg_count, reply_comment_total, nested replies.

**GET /api/tiktok/video/transcript** — Get video transcript text.
| Param | Required | Description |
|-------|----------|-------------|
| url | yes | TikTok video URL |
| language | no | 2-letter language code (en, es, fr) |
| use_ai_as_fallback | no | `true` for AI transcription (under 2 min videos) |

### Search

**GET /api/tiktok/search/keyword** — Search videos by keyword.
| Param | Required | Description |
|-------|----------|-------------|
| query | yes | Search keyword |
| date_posted | no | `yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`, `all-time` |
| sort_by | no | `relevance`, `most-liked`, `date-posted` |
| region | no | 2-letter country code |
| cursor | no | Pagination cursor |

**GET /api/tiktok/search/hashtag** — Search videos by hashtag.
| Param | Required | Description |
|-------|----------|-------------|
| hashtag | yes | Hashtag without # |
| region | no | 2-letter country code |
| cursor | no | Pagination cursor |

**GET /api/tiktok/search/users** — Search TikTok users.
| Param | Required | Description |
|-------|----------|-------------|
| query | yes | Search query |
| cursor | no | Pagination cursor |

**GET /api/tiktok/search/top** — Top search results (videos + photo carousels).
| Param | Required | Description |
|-------|----------|-------------|
| query | yes | Search keyword |
| publish_time | no | `yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`, `all-time` |
| sort_by | no | `relevance`, `most-liked`, `date-posted` |
| region | no | 2-letter country code |
| cursor | no | Pagination cursor |

### Trending

**GET /api/tiktok/get-trending-feed** — Get trending feed for a region.
| Param | Required | Description |
|-------|----------|-------------|
| region | yes | 2-letter country code (US, GB, FR, etc.) |

**GET /api/tiktok/videos/popular** — Get popular videos across TikTok.
| Param | Required | Description |
|-------|----------|-------------|
| period | no | `7` or `30` (days) |
| page | no | Page number |
| orderBy | no | `like`, `hot`, `comment`, `repost` |
| countryCode | no | Country code |

**GET /api/tiktok/creators/popular** — Discover popular creators with filters.
| Param | Required | Description |
|-------|----------|-------------|
| page | no | Page number |
| sortBy | no | `engagement`, `follower`, `avg_views` |
| followerCount | no | `10K-100K`, `100K-1M`, `1M-10M`, `10M+` |
| creatorCountry | no | Creator's country code |
| audienceCountry | no | Audience country code |

**GET /api/tiktok/hashtags/popular** — Get trending hashtags.
| Param | Required | Description |
|-------|----------|-------------|
| period | no | `7`, `30`, or `120` (days) |
| page | no | Page number |
| countryCode | no | Country code |
| newOnBoard | no | Only newly trending |
| industry | no | e.g. `beauty-and-personal-care`, `food-and-beverage`, `tech-and-electronics` |

### Songs

**GET /api/tiktok/song** — Get song details by clip ID.
| Param | Required | Description |
|-------|----------|-------------|
| clipId | yes | Clip ID (not song ID) |

**GET /api/tiktok/song/videos** — Get videos using a specific song.
| Param | Required | Description |
|-------|----------|-------------|
| clipId | yes | Clip ID from song URL |
| cursor | no | Pagination cursor |

**GET /api/tiktok/songs/popular** — Get popular/surging songs (can take up to 30s).
| Param | Required | Description |
|-------|----------|-------------|
| page | no | Page number |
| timePeriod | no | `7`, `30`, or `130` (days) |
| rankType | no | `popular` or `surging` |
| newOnBoard | no | New to top 100 |
| commercialMusic | no | Approved for business use |
| countryCode | no | Country code |

### Instagram Profiles

**GET /api/instagram/profile** — Get an Instagram profile by handle.
| Param | Required | Description |
|-------|----------|-------------|
| handle | yes | Instagram handle (without @) |

Returns: user info (id, username, full_name, biography, bio_links), stats (edge_followed_by, edge_follow), verification status, and recent posts.

**GET /api/instagram/basic-profile** — Get basic profile data by user ID.
| Param | Required | Description |
|-------|----------|-------------|
| userId | yes | Instagram user ID |

Returns: follower_count, following_count, media_count, total_clips_count, bio, verification status.

### Instagram Posts & Reels

**GET /api/instagram/user/posts** — Get a user's posts (paginated).
| Param | Required | Description |
|-------|----------|-------------|
| handle | yes | Instagram handle |
| next_max_id | no | Pagination cursor |

**GET /api/instagram/post** — Get post/reel details by URL.
| Param | Required | Description |
|-------|----------|-------------|
| url | yes | Instagram post or reel URL |

**GET /api/instagram/user/reels** — Get a user's reels (paginated).
| Param | Required | Description |
|-------|----------|-------------|
| user_id | yes (or handle) | Instagram user ID (faster) |
| handle | yes (or user_id) | Instagram handle |
| max_id | no | Pagination cursor |

**GET /api/instagram/reels/search** — Search reels by keyword.
| Param | Required | Description |
|-------|----------|-------------|
| query | yes | Search keyword |
| page | no | Page number |

**GET /api/instagram/post/comments** — Get post comments (paginated).
| Param | Required | Description |
|-------|----------|-------------|
| url | yes | Instagram post or reel URL |
| cursor | no | Pagination cursor |

**GET /api/instagram/media/transcript** — Get transcript from a reel or video post.
| Param | Required | Description |
|-------|----------|-------------|
| url | yes | Instagram post or reel URL |

Returns transcript per carousel item. AI-powered, works for videos under 2 minutes.

### Instagram Highlights

**GET /api/instagram/user/highlights** — Get story highlights from a user.
| Param | Required | Description |
|-------|----------|-------------|
| user_id | yes (or handle) | Instagram user ID |
| handle | yes (or user_id) | Instagram handle |

**GET /api/instagram/user/highlight/detail** — Get specific highlight content.
| Param | Required | Description |
|-------|----------|-------------|
| id | yes | Highlight ID |

**GET /api/instagram/user/embed** — Get HTML embed code for a profile.
| Param | Required | Description |
|-------|----------|-------------|
| handle | yes | Instagram handle |

## Pagination

Paginated endpoints return a cursor field (`cursor`, `min_time`, `max_cursor`, or `next_max_id` depending on the endpoint). Pass it back as a query param for the next page. Stop when the cursor is empty/null or no more items are returned.

## Pricing

1 credit per API call. Free signup gives 250 credits. Paid packs: Starter ($29/5k credits), Pro ($99/20k credits), Scale ($299/100k credits). Credits never expire, no rate limits.