Modash integration

Modash is a creator intelligence platform for discovering, analyzing, and reaching out to social media influencers across Instagram, TikTok, and YouTube. With this integration, you can build creator lists using keyword and AI-powered search, enrich profiles with engagement and audience data, and extract post and comment content — all within Clay.

Creating a table with Modash

1. In a workbook, click + Add at the bottom.
2. Search for Modash and select from the results.
3. In the modal, you will be asked to Select Modash account.
   • If you haven't already connected your Modash account, click + Add account and go through authentication. Otherwise, use the Clay-provided key.

Source Find Instagram creators (keyword search)

Find Instagram creators by keyword.

Inputs

• Search query: Keyword or phrase (e.g., "vegan food NYC", "fitness coach").
• Number of results (optional): How many creators to return.

Outputs

• Results: Array of matching accounts. Each contains:
  • Position: Ranking position in search results.
  • User ID: Instagram user ID.
  • Username: Instagram username.
  • Full name: Display name.
  • Profile picture URL: Avatar image URL.
  • Profile URL: Full Instagram profile URL.

Source Find Instagram creators (AI search)

Find Instagram creators using a natural language description of the content, aesthetic, or audience you're looking for.

Inputs

• Natural language query: Describe your ideal creator (e.g., "woman with curly hair lifting weights"). Max 8,192 characters or 512 words.
• Filters (optional): Follower count range, location, gender, engagement rate, account type, language, has email, brand affinity, last posted within X days, max post age, content type.
• Number of results (optional): Max 1,500 per search.

Outputs

• User ID: Modash user identifier.
• Username: Instagram username.
• Full name: Creator display name.
• Profile URL: Full Instagram profile URL.
• Profile picture URL: Avatar image URL.
• Followers count: Total follower count.
• Engagement rate: Average engagement rate (as a decimal, e.g., 0.04 = 4%).
• Posting frequency (posts/month): Average number of posts per month.
• Account category: Creator category or niche.
• Matched posts: Array of posts that matched the query. Each contains:
  • Post ID
  • Post URL
  • Thumbnail URL
  • Stats (likes count, and additional engagement metrics)

Source Get Instagram post comments

Pull comments from an Instagram post or reel into a table, with one row per comment.

Inputs

• Instagram post URL or shortcode: e.g., https://www.instagram.com/p/ABC123/ or ABC123.

Outputs

• Post URL: URL of the Instagram post.
• Comment ID: Unique identifier for the comment.
• Text: Comment text.
• Created at (Unix timestamp): When the comment was posted.
• Likes: Number of likes on the comment.
• Reply count: Number of replies to the comment.
• User: Commenter details, including User ID, Username, Full name, and Profile picture URL.

Source Find TikTok creators (keyword search)

Find TikTok creators by keyword.

Inputs

• Search query: Keyword or phrase (e.g., "makeup tutorial", "coding tips").
• Number of results (optional): How many creators to return.

Outputs

• Results: Array of matching accounts. Each contains:
  • User ID: TikTok user ID.
  • Username: TikTok username.
  • Nickname: Display name.
  • Bio: Profile bio text.
  • Followers: Follower count.
  • Verification label: Custom verification badge text.
  • Enterprise verification: Enterprise verification reason.
  • Secure user ID: Secure UID.
  • Avatar URL: Profile avatar image URL.
  • Profile URL: Full TikTok profile URL.

Source Find TikTok creators (AI search)

Find TikTok creators using a natural language description.

Inputs

• Natural language query: Describe your ideal creator (max 1,024 characters or 64 words).
• Filters (optional): Follower count range, location, gender, engagement rate, account type, language, has email, brand affinity, last posted within X days, max post age. (Content type filter is not available — TikTok is video-only.)
• Number of results (optional): Max 1,500 per search.

Outputs

• User ID: Modash user identifier.
• Username: TikTok username.
• Full name: Creator display name.
• Profile URL: Full TikTok profile URL.
• Profile picture URL: Avatar image URL.
• Followers count: Total follower count.
• Engagement rate: Average engagement rate (as a decimal).
• Posting frequency (posts/month): Average number of posts per month.
• Account category: Creator category or niche.
• Matched posts: Array of posts that matched the query. Each contains:
  • Post ID
  • Post URL
  • Thumbnail URL
  • Stats (likes count, and additional engagement metrics)

Source Get TikTok video comments

Pull comments from a TikTok video into a table, with one row per comment.

Inputs

• TikTok video URL or video ID: e.g., https://www.tiktok.com/@username/video/123456789 or 123456789.

Outputs

• Video ID: TikTok video ID.
• Comment ID: Unique identifier for the comment.
• Text: Comment text.
• Created at (Unix timestamp): When the comment was posted.
• Like count: Number of likes on the comment.
• Reply count: Number of replies to the comment.
• User: Commenter details, including User ID, Username, Nickname, and Avatar URL.

Enriching data with Modash

1. While in a Clay table, click Add enrichment and search for Modash.
2. Under Integrations, select one of the Modash options.
3. In the modal, you will be asked to Select Modash account.
   • If you have your own account, click + Add account and go through authentication. Otherwise, use the Clay-provided key.

Action Get Instagram profile

Fetch profile information for an Instagram creator including bio, follower count, and account metadata.

Inputs

Required:

• Instagram handle or profile URL: An Instagram username (with or without @) or a full profile URL (e.g., @username or https://instagram.com/username).

Outputs

• Profile URL: Full Instagram profile URL.
• User ID: Instagram user ID.
• Username: Instagram username.
• Full name: Display name.
• Biography: Profile bio text.
• Category: Account category (e.g., "Public figure").
• Follower count: Total followers.
• Following count: Number of accounts followed.
• Media count: Total posts published.
• Is business: Whether the account is a business account.
• Is private: Whether the account is set to private.
• Is verified: Whether the account has a verified badge.
• External URL: Link in bio.
• Profile picture URL: Avatar image URL.
• Profile picture URL (HD): High-resolution avatar image URL.
• Bio links: Array of links in bio. Each contains:
  • Title
  • URL
  • Link type

Action Get Instagram user feed

Fetch a page of recent posts from an Instagram creator. Returns ~12 posts per call.

Inputs

Required:

• Instagram handle or profile URL: An Instagram username (with or without @) or a full profile URL.

Outputs

• Profile URL: Full Instagram profile URL.
• Posts: Array of recent posts. Each contains:
  • Media ID: Unique media identifier.
  • Shortcode: Instagram post shortcode.
  • Caption text: Post caption.
  • Media type: Media type code (1 = photo, 2 = video, 8 = carousel).
  • Product type: Content format (e.g., "clips" for Reels).
  • Taken at (Unix timestamp): When the post was published.

Action Get Instagram post

Fetch information for an Instagram post or reel including caption, engagement metrics, and author details.

Inputs

Required:

• Instagram post URL or shortcode: e.g., https://www.instagram.com/p/DKsBCXrpQTr/ or DKsBCXrpQTr.

Outputs

• Post URL: Full URL of the post.
• Media ID: Unique media identifier.
• Shortcode: Instagram post shortcode.
• Caption text: Post caption.
• Media type: Media type code (1 = photo, 2 = video, 8 = carousel).
• Product type: Content format (e.g., "clips" for Reels).
• Taken at (Unix timestamp): Publication time as Unix timestamp.
• Taken at (UTC): Publication time in ISO 8601 format.
• Like count: Total likes.
• Comment count: Total comments.
• View count: Total views (video posts).
• Play count: Total plays (Reels).
• Video duration (seconds): Length of the video.
• Video URL: Direct video file URL.
• Display image URL: Thumbnail or cover image URL.
• Is paid partnership: Whether the post is a sponsored/paid partnership.
• Has audio: Whether the video has audio.
• User: Author details. Contains:
  • User ID
  • Username
  • Full name
  • Is verified
  • Is private
  • Profile picture URL
• Location: Tagged location. Contains:
  • Location ID
  • Name
  • Address
  • City

Action Get Instagram post comments

Extract comments from an Instagram post or reel, returned as an array attached to the row.

Inputs

Required:

• Instagram post URL or shortcode: e.g., https://www.instagram.com/p/ABC123/ or ABC123.

Outputs

• Post URL: URL of the Instagram post.
• Comments: Array of comments. Each contains:
  • Comment ID: Unique identifier.
  • Text: Comment text.
  • Created at (Unix timestamp): When the comment was posted.
  • Likes: Number of likes on the comment.
  • Reply count: Number of replies.
  • User: Commenter details (User ID, Username, Full name, Profile picture URL).

Action Search Instagram accounts

Search Instagram accounts by keyword and return the top matching profiles. Returns a maximum of 5 accounts per search.

Inputs

Required:

• Search keyword: A keyword to search Instagram accounts by — a name, topic, or username (e.g., "dogs").

Outputs

• Results: Array of matching accounts. Each contains:
  • Position: Ranking position in search results.
  • User ID: Instagram user ID.
  • Username: Instagram username.
  • Full name: Display name.
  • Profile picture URL: Avatar image URL.
  • Profile URL: Full Instagram profile URL.

Action Get TikTok profile

Fetch profile information for a TikTok creator including bio, follower count, and account metadata.

Inputs

Required:

• TikTok handle, profile URL, or user ID: e.g., @username, https://www.tiktok.com/@username, or a numeric user ID.

Outputs

• Profile URL: Full TikTok profile URL.
• User: Account details. Contains:
  • User ID
  • Username
  • Nickname (display name)
  • Bio
  • Is verified
  • Is private
  • Secure user ID
  • Avatar URL (large)
  • Avatar URL (medium)
  • Avatar URL (thumb)
  • Bio link (URL, Risk score)
• Stats: Account statistics. Contains:
  • Follower count
  • Following count
  • Total likes (heart count)
  • Video count
  • Digg count
• Share metadata: Contains:
  • Title
  • Description

Action Get TikTok video

Fetch information for a TikTok video including caption, engagement metrics, and author details.

Inputs

Required:

• TikTok video URL or video ID: e.g., https://www.tiktok.com/@username/video/123456789 or 123456789.

Outputs

• Video URL: Full TikTok video URL.
• Video ID: Unique video identifier.
• Description: Video caption text.
• Created (Unix timestamp): Publication time.
• Video: Video file details. Contains:
  • Video file ID
  • Duration (seconds)
  • Width
  • Height
  • Cover URL
  • Play URL
  • Download URL
• Author: Creator details. Contains:
  • User ID
  • Username
  • Nickname (display name)
  • Bio
  • Is verified
  • Is private
  • Avatar URL
• Stats: Engagement metrics. Contains:
  • Play count
  • Like count
  • Comment count
  • Share count
  • Collect count
• Music: Audio details. Contains:
  • Music ID
  • Title
  • Author

Action Get TikTok video comments

Extract comments from a TikTok video, returned as an array attached to the row.

Inputs

Required:

• TikTok video URL or video ID: e.g., https://www.tiktok.com/@username/video/123456789 or 123456789.

Outputs

• Comments: Array of comments. Each contains:
  • Comment ID: Unique identifier.
  • Text: Comment text.
  • Video ID: ID of the parent video.
  • Created at (Unix timestamp): When the comment was posted.
  • Like count: Number of likes on the comment.
  • Reply count: Number of replies.
  • User: Commenter details (User ID, Username, Nickname, Avatar URL).

Action Search TikTok accounts

Search TikTok accounts by keyword and return the top matching profiles. Returns a maximum of 10 accounts per search.

Inputs

Required:

• Search keyword: A keyword to search TikTok accounts by — a name, topic, or username (e.g., "dogs").

Outputs

• Results: Array of matching accounts. Each contains:
  • User ID: TikTok user ID.
  • Username: TikTok username.
  • Nickname: Display name.
  • Bio: Profile bio text.
  • Followers: Follower count.
  • Verification label: Custom verification badge text.
  • Enterprise verification: Enterprise verification reason.
  • Secure user ID: Secure UID.
  • Avatar URL: Profile avatar image URL.
  • Profile URL: Full TikTok profile URL.

Action Get YouTube channel

Fetch profile information for a YouTube channel including subscriber count, description, and metadata.

Inputs

Required:

• YouTube channel URL or channel ID: e.g., https://www.youtube.com/@GrowWithClay or UCRwHGGFXRRDeuKXkpqgmYbA.

Outputs

• Channel URL: Full YouTube channel URL.
• Channel ID: Unique channel identifier.
• Handle: Channel handle (e.g., @GrowWithClay).
• Custom URL: Channel custom URL slug.
• Username: Channel username.
• Channel name: Display name.
• Description: Channel description.
• Country: Country associated with the channel.
• Subscriber count: Total subscribers.

Action Get YouTube uploaded videos

Pull the most recent videos from a YouTube channel.

Inputs

Required:

• YouTube channel URL or channel ID: e.g., https://www.youtube.com/@GrowWithClay or UCRwHGGFXRRDeuKXkpqgmYbA.

Outputs

• Channel URL: Full YouTube channel URL.
• Videos: Array of uploaded videos. Each contains:
  • Video ID
  • Title
  • Thumbnail URL
  • Duration: Video length (e.g., "12:34").
  • Published ago: Relative publish time (e.g., "3 months ago").
  • View count
• Total video count: Total number of videos on the channel.
• More videos available: Whether additional videos can be fetched with pagination.

Action Get YouTube video

Fetch stats for a specific YouTube video including view count, like count, and metadata.

Inputs

Required:

• YouTube video URL or video ID: e.g., https://www.youtube.com/watch?v=ABC123 or ABC123.

Outputs

• View count: Total views.
• Like count: Total likes.
• Dislike count: Total dislikes.
• Comment count: Total comments.
• Genre: Video genre or category.
• Thumbnail URL: Video thumbnail image URL.
• Keywords: Array of video keywords/tags.
• Available subtitles: Array of subtitle tracks. Each contains:
  • Language code (e.g., en)
  • Language name (e.g., "English")
  • VSS ID: Internal subtitle track identifier.
  • Fetch URL: URL to retrieve the subtitle file.
• Includes paid promotion: Whether the video includes paid promotional content.
• Is premium-only: Whether the video is YouTube Premium exclusive.
• Is members-only: Whether the video is restricted to channel members.
• Collaborators: Array of collaborating channels. Each contains:
  • Channel ID
  • Channel name

Action Get YouTube video subtitles

Fetch the list of available subtitle tracks for a YouTube video, including fetch URLs.

Inputs

Required:

• YouTube video URL or video ID: e.g., https://www.youtube.com/watch?v=ABC123 or ABC123.

Outputs

• Video URL: Full YouTube video URL.
• Subtitles: Array of available subtitle tracks. Each contains:
  • Language code: e.g., en.
  • Language name: e.g., "English".
  • VSS ID: Internal subtitle track identifier.
  • Fetch URL: Direct URL to download the subtitle track content.

Run settings

• Auto-update: Re-run enrichment automatically when source data changes. Useful for monitoring creator profiles that update on a regular cadence.
• Only run if: Set conditions to control when the enrichment runs. Learn more about conditional formulas.

Best practices

For AI search

• Write descriptive queries: Instead of "fitness", try "female fitness coaches who post workout routines for beginners".
• Use filters strategically: Narrow by follower count, location, or engagement rate to get more targeted results.
• Keep page size constant: When requesting large result sets (>50 results), Modash paginates automatically. Changing the page size mid-search may cause duplicate or missed results.

For enrichments

• Handle URLs flexibly: Clay automatically parses handles from full URLs, so you can pass https://instagram.com/username instead of just @username.
• Use conditional runs: Save credits by only enriching profiles that meet certain criteria (e.g., follower count > 10K).
• Combine with AI formulas: After pulling comments or video subtitles, use Clay's AI formulas to analyze sentiment, extract themes, or summarize content.