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.
Common Response Fields
The Social Media PDP Cache agents return the following 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.