--- name: social.gedx402.com description: social.gedx402.com provides structured profile and content data lookups across major social platforms including Twitter/X, TikTok, LinkedIn, YouTube, and Threads. It returns identity fields, follower counts, verification status, and related metadata for individual accounts. It also offers TikTok-specific extensions for audience demographics and shop product reviews. host: social.gedx402.com --- # social.gedx402.com This host serves agents that need to resolve social media identities, retrieve profile metadata, or analyze audience composition across platforms. It covers Twitter/X, TikTok, LinkedIn, YouTube, and Threads through discrete per-platform endpoints. It is not a unified search or analytics platform — each skill targets a specific platform and data type, and most require a known handle, URL, or ID as input. ## When to use this host Use this host when an agent needs to resolve a known social media handle, URL, or channel ID into structured profile data on Twitter/X, TikTok, LinkedIn, YouTube, or Threads. It is also appropriate for fetching a Twitter user's tweet timeline or analyzing TikTok audience demographics and shop product reviews. Do not use this host for keyword or hashtag search across tweets, bulk profile discovery without known identifiers (except Threads username search), real-time streaming or follower tracking, fetching individual YouTube videos or playlists, or retrieving TikTok video content and comments. For LinkedIn profile discovery by name rather than URL, use a LinkedIn search API. For TikTok product metadata or pricing, use a product detail endpoint rather than the review skill here. ## Capabilities ### Social Profile Lookup Retrieves structured identity and profile metadata — including name, bio, follower counts, verification status, and avatar — for accounts on Twitter/X, TikTok, LinkedIn, YouTube, and Threads. - **`fetch-twitter-profile`** — Fetches a Twitter/X user profile by handle, returning identity, bio, avatar URL, follower counts, verification status, and related metadata via SociaVault. - **`fetch-tiktok-profile`** — Fetches a TikTok user profile by handle, returning identity fields, verification status, bio, avatar URLs, follower/following counts, and video stats. - **`fetch-linkedin-profile`** — Fetches structured LinkedIn profile data for a given profile URL, returning name, location, follower count, recent posts, and experience sections. - **`fetch-youtube-channel-metadata`** — Fetches detailed YouTube channel metadata including name, verification status, subscriber count, video count, social links, avatar, and banner images given a channel ID, handle, or URL. - **`search-threads-users`** — Searches Threads by username query and returns matching user profiles including username, display name, verification status, active status, and profile image URL. ### Twitter Timeline Retrieval Fetches a Twitter/X user's recent tweet timeline including full text, media, and pagination cursors, given a numeric user ID resolved from a prior profile lookup. - **`fetch-twitter-user-tweets-all`** — Fetches a Twitter/X user's recent timeline including tweet content, media, and pagination cursors, given a numeric user ID. ### TikTok Audience and Commerce Analytics Extends TikTok profile data with geographic audience demographics and paginated customer review data from TikTok Shop products, enabling creator audience analysis and product sentiment evaluation. - **`fetch-tiktok-demographics`** — Returns audience demographic data for a TikTok handle, including a ranked list of audience locations by country with follower counts and percentages. - **`fetch-tiktok-shop-product-reviews`** — Fetches paginated review data for a TikTok Shop product, returning review text, star ratings, verified-purchase flags, reviewer info, and pagination state. ## Workflows ### Twitter Profile to Timeline Fetch *Use when an agent needs to retrieve a Twitter/X user's recent tweets but only has a handle, not a numeric user ID.* 1. **`fetch-twitter-profile`** — Resolve the Twitter/X handle to a numeric user ID and retrieve profile metadata including follower count and verification status. 2. **`fetch-twitter-user-tweets-all`** — Use the numeric user ID from the profile response to fetch the user's recent tweet timeline with full text, media, and pagination cursors. ### TikTok Creator Profile and Audience Analysis *Use when an agent needs a complete picture of a TikTok creator including their identity, follower count, and the geographic distribution of their audience.* 1. **`fetch-tiktok-profile`** — Fetch the creator's profile including follower count, verification status, bio, and avatar URLs. 2. **`fetch-tiktok-demographics`** — Fetch the geographic audience breakdown for the same handle to identify top countries where the creator's followers are located. ## Skill reference ### `fetch-linkedin-profile` **LinkedIn Profile Lookup** — Fetches structured LinkedIn profile data for a given profile URL, returning name, location, follower count, recent posts, and experience sections. *Use when:* Use when an agent needs structured data from a LinkedIn profile — such as name, location, follower count, recent posts, or work experience — given a LinkedIn profile URL. *Not for:* Do not use for bulk LinkedIn searches or finding profiles by name without a known URL; use a LinkedIn search API instead. Not suitable for real-time follower tracking or streaming updates. **Inputs:** - `url` (string, required) — The full LinkedIn profile URL to fetch data for. **Returns:** Returns a JSON object with success=true, provider metadata, and a nested data object containing the profile's name, image URL, location, follower count, about text, recent posts array, and experience entries. **Example:** `{"url": "https://www.linkedin.com/in/parrsam/"}` --- ### `fetch-tiktok-profile` **TikTok Profile Lookup** — Fetches a TikTok user profile by handle, returning identity fields, verification status, bio, avatar URLs, follower/following counts, and video stats. *Use when:* Use when an agent needs structured TikTok profile data for a given username, such as verifying account identity, retrieving follower counts, checking verification status, or extracting bio and avatar URLs. *Not for:* Do not use for fetching TikTok video content, comments, or trending feeds; this endpoint returns profile-level data only. **Inputs:** - `handle` (string, required) — TikTok username (handle) to look up, without the @ symbol. **Returns:** Returns a nested data object with TikTok user identity (id, uniqueId, nickname), verified status, bio signature, three avatar URLs, a bio link, privacy flags, and both approximate and precise follower/following/heart/video counts. **Example:** `{"handle": "stoolpresidente"}` --- ### `fetch-youtube-channel-metadata` **YouTube Channel Data** — Fetches detailed YouTube channel metadata including name, verification status, subscriber count, video count, social links, avatar, and banner images given a channel ID, handle, or URL. *Use when:* Use when an agent needs structured profile data for a YouTube channel, such as subscriber count, video count, verification status, country, linked social accounts, or avatar/banner assets, given a channel ID, handle, or URL. *Not for:* Do not use for fetching individual video metadata or a channel's video list; use a video or playlist endpoint instead. Not suitable for real-time subscriber count streaming. **Inputs:** - `channelId` (string) — YouTube channel ID. At least one of channelId, handle, or url must be provided. - `handle` (string) — YouTube channel handle (without or without @). At least one of channelId, handle, or url must be provided. - `url` (string) — Full YouTube channel URL. At least one of channelId, handle, or url must be provided. **Returns:** Returns success=true with a data object containing channel name, verification status, 2.99M subscribers, 11,063 videos, country, linked social URLs, avatar image sources, and multi-resolution banner images. **Example:** `{"url": "https://www.youtube.com/@ThePatMcAfeeShow", "handle": "ThePatMcAfeeShow", "channelId": "UC-9-kyTW8ZkZNDHQJ6FgpwQ"}` --- ### `fetch-twitter-user-tweets-all` **Twitter User Tweets (All)** — Fetches a Twitter/X user's recent timeline including tweet content, media, and pagination cursors, given a numeric user ID. *Use when:* Use when an agent needs to retrieve a Twitter/X user's recent tweets including full text, media attachments, and top/bottom pagination cursors for iterating through their timeline. *Not for:* Do not use to look up a user's numeric ID from a handle — use a profile/user-lookup endpoint first. Not suitable for searching tweets by keyword or hashtag. **Inputs:** - `user_id` (string, required) — Twitter numeric user ID (rest_id). Use a profile endpoint to resolve this from a screen name/handle. - `cursor` (string) — Pagination cursor from a previous response (top or bottom) to fetch the next or previous page of results. **Returns:** Returns success=true with a paginated timeline containing tweet entries (full_text, media, created_at, ids) and top/bottom pagination cursors for the requested user. **Example:** `{"user_id": "44196397"}` --- ### `fetch-twitter-profile` **Twitter Profile Lookup** — Fetches a Twitter/X user profile by handle, returning identity, bio, avatar URL, follower counts, verification status, and related metadata via SociaVault. *Use when:* Use when an agent needs structured Twitter/X profile data for a given handle, such as follower count, bio description, avatar, Blue verification status, account creation date, or affiliated label. *Not for:* Do not use for fetching tweets, timelines, or search results; use a dedicated tweet or search endpoint instead. Not suitable for bulk or streaming profile lookups. **Inputs:** - `handle` (string, required) — Twitter/X screen name (handle) to look up, without the @ symbol. **Returns:** Returns success=true with a nested data object containing the user's display name, screen name, bio, follower/following counts, avatar URL, Blue verification status, account creation date, location, and scrape metadata including latency and credits used. **Example:** `{"handle": "Austen"}` --- ### `fetch-tiktok-shop-product-reviews` **TikTok Shop Product Reviews** — Fetches paginated review data for a TikTok Shop product, returning review text, star ratings, verified-purchase flags, reviewer info, and pagination state. *Use when:* Use when an agent needs customer review content for a TikTok Shop product, such as sentiment analysis, review aggregation, or displaying ratings and reviewer details for a specific product identified by URL or product ID. *Not for:* Do not use for retrieving product metadata, pricing, or inventory; use a product detail endpoint instead. Not suitable for bulk review scraping across many products in a single call — paginate sequentially instead. **Inputs:** - `url` (string) — Full TikTok Shop product page URL. Required if product_id is not provided. - `product_id` (string) — TikTok Shop product ID. Required if url is not provided. - `page` (integer) — Page number of reviews to retrieve, starting at 1. **Returns:** Returns success=true with a product_reviews object containing up to 10 paginated reviews per page, each including review text, star rating, verified-purchase flag, reviewer name and avatar, country, and timestamp, plus total_reviews count and has_more pagination indicator. **Example:** `{"url": "https://www.tiktok.com/shop/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516", "product_id": "1731578642912612516", "page": 1}` --- ### `fetch-tiktok-demographics` **TikTok Demographics** — Returns audience demographic data for a TikTok handle, including a ranked list of audience locations by country with follower counts and percentages. *Use when:* Use when an agent needs to analyze the geographic audience distribution of a TikTok account, such as identifying top countries where a creator's followers are located. *Not for:* Do not use for real-time follower counts, engagement metrics, or content analytics; use a dedicated TikTok analytics endpoint for those data points. **Inputs:** - `handle` (string, required) — TikTok handle (username) of the account to retrieve audience demographics for. **Returns:** Returns success=true with a ranked audienceLocations map where each entry contains country, countryCode, follower count, and percentage; Brazil led with 40 followers (26.67%) for the shakira handle. **Example:** `{"handle": "shakira"}` --- ### `search-threads-users` **Threads User Search** — Searches Threads by username query and returns matching user profiles including username, display name, verification status, active status, and profile image URL. *Use when:* Use when an agent needs to discover or look up Threads accounts by name or username fragment, such as finding a specific person's Threads profile or enumerating accounts matching a keyword. *Not for:* Do not use for fetching a specific user's posts or thread content; use a Threads post/feed endpoint instead. Not suitable for Instagram-only account lookups. **Inputs:** - `query` (string, required) — Username or name fragment to search for on Threads. **Returns:** Returns a success flag and a numbered object of matching Threads user profiles, each containing username, full_name, pk/id, is_verified, is_active_on_text_post_app, and profile_pic_url. **Example:** `{"query": "shams"}` ---