> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veedcrawl.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Audit a Creator's Content with Veedcrawl
> Turn a single username into a complete creator audit — bio, engagement stats, top-performing videos, transcripts, and structured content analysis.
With Veedcrawl's profile endpoints, you can audit any public creator from scratch using only their username. No video URLs required. Start with a single `GET` request to pull their bio, follower count, and up to 24 recent posts. From there, chain directly into transcripts and structured extraction on your top performers — the response gives you every video URL you need.
Call `/v1/instagram/profile` with the creator's username and set `limit=24` to retrieve their full recent posting history alongside bio and audience stats.
```bash theme={null}
curl "https://api.veedcrawl.com/v1/instagram/profile?username=natgeo&limit=24" \
-H "x-api-key: YOUR_KEY"
```
The response includes follower count, verified status, and a `videos` array of up to 24 recent posts — each with per-post view and like counts:
```json theme={null}
{
"platform": "instagram",
"type": "profile",
"username": "natgeo",
"author": {
"username": "natgeo",
"displayName": "National Geographic",
"avatarUrl": "https://instagram.f.../profile_pic.jpg",
"verified": true
},
"stats": {
"followers": 283000000,
"following": 170,
"posts": 31400
},
"videos": [
{
"platform": "instagram",
"type": "video",
"id": "3383000000000000000",
"url": "https://www.instagram.com/p/ABC123XYZ/",
"title": "The Amazon is disappearing faster than ever before.",
"stats": { "views": 4800000, "likes": 612000, "comments": 4300, "shares": null },
"media": {
"type": "video",
"thumbnailUrl": "https://...",
"videoUrl": "https://....mp4"
},
"createdAt": "2026-05-01T09:14:00.000Z"
}
]
}
```
For each post in the `videos` array, divide `likes` by the profile-level `followers` count to get engagement rate. Sort descending and select your top 3 performers.
```
engagement_rate = post.stats.likes / profile.stats.followers
```
A post with 612,000 likes on a 283M-follower account has an engagement rate of roughly **0.22%** — already above typical brand benchmarks. Pick the posts with the highest engagement rates to analyze further.
For each top-performing video post, send its `url` directly to `/v1/transcript`. The URL comes straight from the profile response — no manual lookup needed.
```bash theme={null}
curl -X POST "https://api.veedcrawl.com/v1/transcript" \
-H "x-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.instagram.com/p/ABC123XYZ/", "mode": "auto"}'
```
This enqueues a job and returns a `jobId`:
```json theme={null}
{ "jobId": "job_abc123", "status": "queued" }
```
Poll until `status` is `"completed"`:
```bash theme={null}
curl "https://api.veedcrawl.com/v1/transcript/job_abc123" \
-H "x-api-key: YOUR_KEY"
```
```json theme={null}
{
"jobId": "job_abc123",
"status": "completed",
"resultJson": {
"text": "The Amazon rainforest is losing ground at a rate we've never recorded before..."
}
}
```
The `videoUrl` field inside each video's `media` object is a direct media URL — pass it into `/v1/transcript` exactly as returned. No modifications needed.
Send each top video to `/v1/extract` with a prompt targeting the content patterns you care about. This watches the full video and returns structured answers.
```bash theme={null}
curl -X POST "https://api.veedcrawl.com/v1/extract" \
-H "x-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/p/ABC123XYZ/",
"prompt": "Extract the hook, CTA, and content structure"
}'
```
Poll the returned `jobId` to get results:
```bash theme={null}
curl "https://api.veedcrawl.com/v1/extract/job_xyz456" \
-H "x-api-key: YOUR_KEY"
```
```json theme={null}
{
"jobId": "job_xyz456",
"status": "completed",
"resultJson": {
"hook": "Opens with a stark aerial shot and the line: 'This is what losing looks like'",
"cta": "Follow for weekly dispatches from the field",
"structure": "Problem statement → field evidence → expert quote → call to action"
}
}
```
Combine the data from steps 1–4 into a structured creator audit:
* **Profile summary** — follower count, verified status, posting cadence, total posts
* **Engagement analysis** — average and top engagement rates across the 24 posts
* **Top content** — titles, view counts, and like counts for your top performers
* **Content patterns** — recurring hooks, CTAs, and structural formats from the extraction results
* **Transcript highlights** — key claims or language patterns from the spoken content
All of this comes from a single username. The API gives you everything else.
Instagram profiles return real follower and following counts from Instagram's web profile API. TikTok profiles return total video count and per-video engagement stats (views, likes, comments, shares) — but follower counts are not available from TikTok's public profile data.
## Data available by platform
Use this table to understand which fields are available when auditing TikTok versus Instagram creators:
| Data point | TikTok | Instagram |
| ---------------------------------------- | ------ | --------------- |
| Display name | ✓ | ✓ |
| Avatar URL | — | ✓ |
| Verified badge | ✓ | ✓ |
| Bio / description | — | ✓ |
| Follower count | — | ✓ |
| Following count | — | ✓ |
| Total post count | ✓ | ✓ |
| Per-post views | ✓ | ✓ (videos only) |
| Per-post likes | ✓ | ✓ |
| Per-post comments | ✓ | ✓ |
| Per-post shares | ✓ | — |
| Captions / descriptions | ✓ | ✓ |
| Hashtags / tags | ✓ | — |
| Thumbnails | ✓ | ✓ |
| Direct video URL | — | ✓ (videos only) |
| Publish timestamp | ✓ | ✓ |
| Media type (video / image / carousel) | — | ✓ |
| Chain into /v1/transcript or /v1/extract | ✓ | ✓ |