Skip to main content

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.

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.
1

Fetch the creator's profile

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.
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:
{
  "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"
    }
  ]
}
2

Calculate engagement rate and identify top performers

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.
3

Transcribe each top video

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.
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:
{ "jobId": "job_abc123", "status": "queued" }
Poll until status is "completed":
curl "https://api.veedcrawl.com/v1/transcript/job_abc123" \
  -H "x-api-key: YOUR_KEY"

{
  "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.
4

Extract hook, CTA, and content structure

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.
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:
curl "https://api.veedcrawl.com/v1/extract/job_xyz456" \
  -H "x-api-key: YOUR_KEY"

{
  "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"
  }
}
5

Synthesize the creator audit report

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 pointTikTokInstagram
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✓✓