Skip to main content
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