Social Media
Learn the common fields for social media profile PDP endpoints and example domains.
Social Media PDP Cache agents extract structured data from social media profile pages, including username, display name, type, contact info, address, description, verification, followers, social links, and recent posts.
Description
Social media profile agents return normalized fields for profiles: username, display name, profile type (e.g. Internet Service Provider, Sport and recreation, community), email, phone, address (city, street, country, district), description/bio, verified status, followers, following, subscribers, num_posts, social_links (x, tiktok, threads, youtube, telegram, instagram), website, profile_picture, and recent_posts (title, posted, post_url, num_views, thumbnail, description).
Common Fields
| Field | Type | Description |
|---|---|---|
username | string | Profile username/handle |
display_name | string | Profile display name |
type | string | Profile type (e.g. Internet Service Provider, Sport and recreation, community) |
email | string | Contact email |
phone | string | Contact phone number |
address | object | city, street, country, district |
description | string | Profile bio or description |
verified | string | Verified status (e.g. true/false) |
followers | number | Follower count |
following | number | Following count |
subscribers | number | Subscriber count |
num_posts | number | Number of posts |
social_links | object | x, tiktok, threads, youtube, telegram, instagram (URLs) |
website | string | Website URL |
profile_picture | string | Profile picture URL |
recent_posts | array | Objects: title, posted (date or relative e.g. 1 day ago), post_url, num_views, thumbnail, description |
Example Domains / URLs
Social media PDP agents are typically available for major platforms, for example:
- Facebook — e.g.
https://www.facebook.com/... - Instagram — e.g.
https://www.instagram.com/... - YouTube (channels) — e.g.
https://www.youtube.com/@...,https://www.youtube.com/channel/... - TikTok — e.g.
https://www.tiktok.com/@... - X (Twitter) — e.g.
https://x.com/... - LinkedIn (company/personal profiles) — e.g.
https://www.linkedin.com/company/...,https://www.linkedin.com/in/... - Threads — e.g.
https://www.threads.net/@...
Check the Marketplace for the full list of supported social media domains.