TikTok Profile Parser

Extract a TikTok profile's bio, avatar, follower stats, and recent posts from the profile HTML.

TikTok Profile Parser

Overview

This parser extracts comprehensive profile information from TikTok profiles, including user details, engagement metrics, and recent content. Perfect for creator analytics, social media monitoring, or building influencer dashboards.

Simply provide the raw HTML of any public TikTok profile page to receive clean, structured JSON data.

Key Takeaways

  • Normalize any public TikTok profile HTML into structured JSON with viewer-ready metrics.
  • Capture creator bios, engagement stats, and recent posts for growth dashboards or campaign tracking.
  • Reuse the schema alongside other Parseium parsers to compare creators across networks.

Table of Contents

Key Data Outputs

Profile Information

The parser extracts core profile details including the creator's avatar, bio, display name, and username.

Engagement Statistics

Get key metrics including follower count, following count, and cumulative likes received. All numeric values are returned as integers for easy analysis.

Recent Posts

Access an array of the user's latest posts, with each entry including:

  • Badge — Special indicators (e.g., sponsored, pinned)
  • Caption — The post description text
  • Thumbnail — Preview image URL
  • Type — Content format (video, image, etc.)
  • URL — Direct link to the post
  • Views — View count as an integer

How It Works

  1. Capture the HTML for a public TikTok profile page.
  2. Send the payload to Parseium's tiktok-profile endpoint together with your API key.
  3. Receive structured JSON that mirrors the schema below and stream it into your analytics stack.

Implementation Steps

  1. Gather profile HTML manually or via a scheduled crawler.
  2. Submit the HTML to Parseium and persist the JSON result.
  3. Normalize field names across social networks so BI teams can blend datasets.
  4. Trigger alerts when engagement metrics or badge states shift.

Best Practices

  • Refresh creator data frequently during active campaigns to capture rapid growth.
  • Combine view counts with campaign tracking links to measure ROI.
  • Store historical snapshots to chart engagement velocity over time.
  • Use Parseium webhooks or actions to notify teams when follower milestones are reached.

Use Cases

  • Track creator growth and engagement trends in real time.
  • Build influencer discovery and analytics platforms.
  • Monitor brand partnerships, sponsored content, and posting cadence.
  • Aggregate data for social media research or investor reporting.

Next Steps

Review the Parseium docs [blocked] for authentication, quotas, and parser guidance. Connect the response to the Prebuilt CTA workflow to convert visitors who are ready to deploy creator analytics.

JSON Response

{
  "content": {
    "posts": [
      {
        "badge": {
          "type": "string"
        },
        "caption": {
          "type": "string"
        },
        "thumbnail": {
          "type": "string"
        },
        "type": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "views": {
          "format": "int",
          "type": "number"
        }
      }
    ]
  },
  "profile": {
    "avatar": {
      "type": "string"
    },
    "bio": {
      "type": "string"
    },
    "display_name": {
      "type": "string"
    },
    "username": {
      "type": "string"
    }
  },
  "stats": {
    "followers": {
      "format": "int",
      "type": "number"
    },
    "following": {
      "format": "int",
      "type": "number"
    },
    "likes": {
      "format": "int",
      "type": "number"
    }
  }
}

API Call (TypeScript)

// TypeScript example: call the TikTok profile pre-built parser
// Set PARSIUM_API_KEY in your environment (e.g. .env.local)

async function run() {
  const parserName = 'tiktok-profile';
  // Provide the raw HTML of a public TikTok profile page
  const html = '<!doctype html>...';

  const res = await fetch(`https://api.parseium.com/v1/parse/${parserName}`, {
    method: 'POST',
    headers: {
      'X-API-Key': process.env.PARSIUM_API_KEY ?? '',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ html }),
  });

  if (!res.ok) {
    throw new Error(`Request failed: ${res.status} ${res.statusText}`);
  }

  const data = await res.json();
  console.log(data);
}

run().catch(console.error);

FAQ

Can I parse private or restricted TikTok profiles?

No. The parser only supports public profiles accessible without authentication to respect TikTok's terms and user privacy.

Does the parser include video performance metrics beyond views?

The current schema returns view counts. Pair it with TikTok's analytics or campaign tracking for deeper performance insights.

How often should I rerun the parser for active creators?

During campaigns, many teams refresh daily or even hourly. Outside of campaigns, weekly snapshots usually suffice.

Can I differentiate sponsored or pinned content?

Yes. The badge field highlights special indicators so you can flag sponsored, pinned, or verified posts in downstream dashboards.

Conclusion

The TikTok Profile Parser turns unstructured profile pages into analysis-ready data for marketing, product, and operations teams. Blend it with other Parseium parsers to deliver cross-network creator intelligence.

Free your Data

Stop wasting hours writing parsing scripts for each site. Stop overpaying for tokens with LLM extraction.

  • easy integration
  • one simple API call
  • fast and accurate
  • scalable performance
  • thousands of pages per day