Skip to main content

Endpoint Reference

Complete reference of all 115+ endpoints available through the Anysite MCP Server. For architecture overview and getting started, see MCP Server Overview.
All endpoints below are called via execute(source, category, endpoint, params). Endpoint names listed here are used as the endpoint parameter. Use discover(source, category) to find the exact parameter schema for any endpoint.Every execute() call returns a cache_key — use it with query_cache and export_data for server-side filtering, aggregation, and export.

Quick Navigation


Source: duckduckgo | Category: search Web search parser (DuckDuckGo) returning structured results. Description: Web search parser by query. Returns up to 20 results sorted by relevance. Powered by DuckDuckGo. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
querystring✅ Yes-Search query (e.g., ‘python fastapi’)-
countinteger❌ Optional10Maximum number of resultsMin: 1, Max: 20
request_timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "query": "fastapi tutorial",
  "count": 15,
  "request_timeout": 300
}
Use Cases:
  • Web research and information gathering
  • Finding documentation and tutorials
  • Competitive intelligence
  • Content discovery

Y Combinator

Source: yc | Categories: company, search
Y Combinator endpoints provide access to startup intelligence, company data, and founder information from the world’s most prestigious startup accelerator.

get_yc_company

Get comprehensive information about a Y Combinator company by its slug. Description: Get Y Combinator company information including description, batch, founders, and metrics. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
slugstring✅ Yes-Y Combinator company slug (e.g., “airbnb”, “stripe”, “reddit”)-
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "slug": "airbnb",
  "timeout": 300
}
Response includes:
  • Company name and description
  • YC batch (e.g., “W09”, “S16”)
  • Company status (Active, Acquired, Public, Inactive)
  • Website and social links
  • Founded year and team size
  • Location and tags/industries
  • Founder information
Use Cases:
  • Startup research and competitive intelligence
  • Investment pipeline analysis
  • Batch cohort studies
  • Founder background research

search_yc_companies

Search Y Combinator companies with advanced filtering options. Description: Search YC companies by keywords, batch, industry tags, and status filters. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
querystring❌ Optional""Search keywords (company name, description, tags)-
batchstring❌ Optional-Filter by batch (e.g., “W23”, “S22”)-
statusstring❌ Optional-Filter by status: “Active”, “Acquired”, “Public”, “Inactive”-
tagsarray[string]❌ Optional-Filter by industry tags/categories-
countinteger❌ Optional10Maximum number of resultsMin: 1, Max: 100
offsetinteger❌ Optional0Pagination offsetMin: 0
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "query": "AI",
  "batch": "W23",
  "count": 20,
  "timeout": 300
}
Use Cases:
  • Find companies in specific batches
  • Research companies by industry/vertical
  • Track acquisitions and successful exits
  • Discover emerging startups
  • Build investment deal flow

search_yc_founders

Search Y Combinator founders with filters for batch, company, industry, and titles. Description: Search YC founders by name, company, batch, industry, and job title. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
querystring❌ Optional""Search by founder name-
companystring❌ Optional-Filter by company slug-
batchstring❌ Optional-Filter by batch (e.g., “W23”, “S22”)-
industriesarray[string]❌ Optional-Filter by YC industries-
titlesarray[string]❌ Optional-Filter by founder titles (CEO, CTO, etc.)-
top_companyboolean❌ OptionalfalseFilter for founders of top YC companies only-
pageinteger❌ Optional0Page number for paginationMin: 0
hits_per_pageinteger❌ Optional100Results per pageMin: 1, Max: 100
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "query": "Sam Altman",
  "industries": ["AI", "Enterprise"],
  "top_company": true,
  "hits_per_page": 20,
  "timeout": 300
}
Response includes:
  • Founder name (first and last)
  • Current company and title
  • Company slug for further queries
  • YC batches and industries
  • Avatar/profile picture
  • All companies text
  • Top company indicator
Use Cases:
  • Founder background research
  • Talent sourcing and recruiting
  • Network mapping and connections
  • Leadership team analysis
  • Serial entrepreneur identification

YouTube

Source: youtube | Categories: search, video, channel
YouTube endpoints provide access to video search, channel videos, detailed video information, comments, and subtitle extraction capabilities.

search_youtube_videos

Search YouTube videos by query with result limit control. Description: Search YouTube videos by query and return structured video data including titles, descriptions, views, and engagement metrics. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
querystring✅ Yes-Search query (e.g., “python tutorial”, “machine learning basics”)-
countinteger✅ Yes-Maximum number of results to returnMin: 1, Max: 600
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "query": "fastapi tutorial",
  "count": 20,
  "timeout": 300
}
Response includes:
  • Video ID and URL
  • Title and description
  • View count, likes, and comments
  • Upload date and duration
  • Channel information
  • Thumbnail URLs
Use Cases:
  • Content research and discovery
  • Competitor analysis
  • Educational resource finding
  • Video trend analysis
  • Content strategy planning

get_youtube_video

Get comprehensive details about a specific YouTube video by ID or URL. Description: Retrieve detailed information about a YouTube video including metadata, engagement metrics, channel data, and video statistics. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
videostring✅ Yes-YouTube video ID or full URL-
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "video": "dQw4w9WgXcQ",
  "timeout": 300
}
Or with full URL:
{
  "video": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "timeout": 300
}
Response includes:
  • Complete video metadata
  • View count, likes, dislikes
  • Comment count and statistics
  • Upload date and duration
  • Channel information (name, subscribers)
  • Video description and tags
  • Category and language
  • Thumbnail images
Use Cases:
  • Video analytics and monitoring
  • Content performance tracking
  • Competitor video analysis
  • SEO research
  • Engagement metrics collection

get_youtube_video_subtitles

Extract subtitles/captions from a YouTube video in specified language. Description: Retrieve video subtitles (closed captions) with timestamps for accessibility, content analysis, or transcription purposes. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
videostring✅ Yes-YouTube video ID or full URL-
langstring❌ Optional”en”Language code (ISO 639-1 format: ‘en’, ‘ru’, ‘es’, etc.)-
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "video": "dQw4w9WgXcQ",
  "lang": "en",
  "timeout": 300
}
Response includes:
  • Full subtitle text
  • Individual subtitle lines with timestamps
  • Language information
  • Subtitle count and duration
  • Timing synchronization data
Use Cases:
  • Content transcription
  • Accessibility compliance
  • Video content analysis
  • Translation workflows
  • SEO content extraction
  • Educational material preparation

get_youtube_channel_videos

Get all videos from a YouTube channel by URL, alias, or ID. Description: Retrieve a list of all videos from a YouTube channel including metadata, engagement metrics, and upload information. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
channelstring✅ Yes-YouTube channel URL, alias (@username), or channel ID-
countinteger❌ Optional50Maximum number of videos to returnMin: 1, Max: 600
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "channel": "https://www.youtube.com/@mkbhd",
  "count": 30,
  "timeout": 300
}
Or with channel alias:
{
  "channel": "@mkbhd",
  "count": 50
}
Response includes:
  • Video ID and URL for each video
  • Title and description
  • View count, likes, and comments
  • Upload date and duration
  • Thumbnail URLs
  • Channel information
Use Cases:
  • Channel content audit
  • Competitor channel analysis
  • Content calendar research
  • Video performance benchmarking
  • Influencer video inventory

get_youtube_video_comments

Get comments for a YouTube video by ID or URL. Description: Retrieve comments from a YouTube video including author information, like counts, and reply data. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
videostring✅ Yes-YouTube video ID or full URL-
countinteger❌ Optional50Maximum number of comments to returnMin: 1, Max: 600
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "video": "dQw4w9WgXcQ",
  "count": 100,
  "timeout": 300
}
Or with full URL:
{
  "video": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "count": 50
}
Response includes:
  • Comment text and author
  • Author channel information
  • Like count and reply count
  • Comment timestamp
  • Is reply flag
  • Author profile image
Use Cases:
  • Sentiment analysis
  • Community feedback research
  • Product mention tracking
  • Competitor comment monitoring
  • Influencer engagement analysis

SEC

Source: sec | Categories: search, document
SEC endpoints provide access to U.S. Securities and Exchange Commission EDGAR database for company filings, financial documents, and regulatory disclosures.

search_sec_companies

Search SEC EDGAR database for company filings with advanced filtering options. Description: Search for SEC filings by company name, ticker symbol, form types, date ranges, and location filters. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
entity_namestring❌ Optional""Company name or ticker symbol (e.g., “Apple”, “AAPL”)-
formsarray[string]❌ OptionalnullForm types to include (e.g., [“10-K”, “10-Q”, “8-K”]) or exclude with ’-’ prefix (e.g., [“-3”, “-4”])-
location_codesarray[string]❌ OptionalnullState codes to filter by (e.g., [“CA”, “NY”])-
date_fromstring❌ OptionalnullStart date in YYYY-MM-DD format-
date_tostring❌ OptionalnullEnd date in YYYY-MM-DD format-
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "entity_name": "Apple",
  "forms": ["10-K", "10-Q"],
  "date_from": "2024-01-01",
  "date_to": "2024-12-31",
  "timeout": 300
}
Response includes:
  • Accession number (unique filing ID)
  • File name and document type
  • Filing date
  • Company CIK (Central Index Key)
  • Form type
  • Document URLs for retrieval
Use Cases:
  • Financial research and analysis
  • Due diligence investigations
  • Regulatory compliance monitoring
  • Investment research
  • Company intelligence gathering
  • Historical filing analysis

get_sec_document

Retrieve the full content of a specific SEC EDGAR document by its URL. Description: Fetch and parse SEC EDGAR documents including 10-K, 10-Q, 8-K, proxy statements, and other regulatory filings. Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
document_urlstring✅ Yes-Direct URL to SEC EDGAR document (obtained from search results)-
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "document_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036125044561/ef20060722_8k.htm",
  "timeout": 300
}
Response includes:
  • Document URL
  • Full document content (HTML or XML)
  • Content type
  • Parsed and cleaned document text
Use Cases:
  • Financial statement analysis
  • Risk factor assessment
  • Management discussion review (MD&A)
  • Executive compensation analysis
  • Merger and acquisition research
  • Legal and regulatory compliance
Common Form Types:
  • 10-K: Annual report with comprehensive company overview
  • 10-Q: Quarterly financial report
  • 8-K: Current report for significant events
  • DEF 14A: Proxy statement (shareholder meetings)
  • S-1: Registration statement for new securities
  • 4: Statement of changes in beneficial ownership

LinkedIn

Source: linkedin | Categories: search, user, company, post, email, job_search, group, google
LinkedIn is the most comprehensive category with 31 endpoints covering profiles, companies, posts, search, skills, experience, and engagement data.

Search & Discovery

Category: search

search_linkedin_users

Search for LinkedIn users based on various criteria. Description: Search for LinkedIn users based on various criteria Parameters:
ParameterTypeRequiredDefaultDescription
keywordsstring❌ Optional-General search keywords
first_namestring❌ Optional-Filter by first name
last_namestring❌ Optional-Filter by last name
titlestring❌ Optional-Filter by job title
company_keywordsstring❌ Optional-Filter by company name
school_keywordsstring❌ Optional-Filter by school name
locationstring❌ Optional-Filter by location name
countinteger❌ Optional10Number of results
request_timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "keywords": "software engineer",
  "location": "San Francisco",
  "count": 20
}

search_linkedin_companies

Search LinkedIn companies with advanced filtering options. Description: Search LinkedIn companies Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
countinteger✅ Yes-Max result countMax: 1000
keywordsstring❌ Optional""Any keyword for searching in the company page. For exact search put desired keywords into brackets-
locationstring❌ Optional[]Location URN or location name-
industrystring❌ Optional[]Industry URN or industry name-
employee_countarray[string]❌ Optional[]Employee count filter-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "keywords": "software company",
  "location": "United States",
  "count": 100
}

search_linkedin_educations

Search educational institutions on LinkedIn. Description: Search LinkedIn educations Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
namestring✅ Yes-Education name-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "name": "Stanford University",
  "count": 10
}

search_linkedin_industries

Search industries on LinkedIn. Description: Search LinkedIn industries Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
namestring✅ Yes-Industry name-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "name": "Software",
  "count": 10
}

search_linkedin_locations

Search locations on LinkedIn for use in filters. Description: Search LinkedIn locations Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
namestring✅ Yes-Location name-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "name": "San Francisco",
  "count": 10
}

User Profiles

Category: user

get_linkedin_profile

Get detailed information about a LinkedIn profile including experience, education, and skills. Description: Get detailed information about a LinkedIn profile Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
userstring✅ Yes-LinkedIn profile URL or username-
request_timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
with_experienceboolean❌ OptionaltrueInclude experience data-
with_educationboolean❌ OptionaltrueInclude education data-
with_skillsboolean❌ OptionaltrueInclude skills data-
Example:
{
  "user": "https://www.linkedin.com/in/john-doe",
  "with_experience": true,
  "with_education": true,
  "with_skills": true
}

find_linkedin_user_email

Find LinkedIn user by email address. Description: Find LinkedIn user email Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
emailstring✅ Yes-Email to get user by email-
countinteger❌ Optional5Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "email": "john.doe@example.com"
}

get_linkedin_user_email_db

Get LinkedIn user email from internal database. Description: Get LinkedIn user email from database Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
profilestring✅ Yes-LinkedIn internal_id, profile URL, alias, or set of them (max 10)-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "profile": "https://www.linkedin.com/in/john-doe"
}

get_linkedin_user_posts

Get posts from a LinkedIn user profile. Description: Get LinkedIn user posts Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urnstring✅ Yes-User URN (fsd_profile type) or user URL-
countinteger✅ Yes-Max result count-
posted_afterstring❌ Optional-Filter posts created after specified date (timestamp)-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "urn": "urn:li:fsd_profile:ACoAAABCDEF",
  "count": 20
}

get_linkedin_user_comments

Get comments from a LinkedIn user. Description: Get LinkedIn user comments Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urnstring✅ Yes-User URN (fsd_profile type only)-
countinteger✅ Yes-Max result count-
commented_afterstring❌ Optional-Filter comments created after specified date (timestamp)-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "urn": "urn:li:fsd_profile:ACoAAABCDEF",
  "count": 50
}

get_linkedin_user_reactions

Get reactions from a LinkedIn user. Description: Get LinkedIn user reactions Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urnstring✅ Yes-User URN (fsd_profile type only)-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "urn": "urn:li:fsd_profile:ACoAAABCDEF",
  "count": 100
}

Company Information

Category: company

get_linkedin_company

Get comprehensive LinkedIn company information. Description: Get LinkedIn company information Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
companystring✅ Yes-Company Alias or URL or URN-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "company": "https://www.linkedin.com/company/microsoft"
}

get_linkedin_company_employee_stats

Get employee statistics for a LinkedIn company. Description: Get LinkedIn company employee statistics Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urnstring✅ Yes-Company URN-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "urn": "urn:li:company:1234"
}

get_linkedin_company_posts

Get posts from a LinkedIn company page. Description: Get LinkedIn company posts Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urnstring✅ Yes-Company URN (company type only)-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "urn": "urn:li:company:1234",
  "count": 20
}

Content & Posts

Category: post

search_linkedin_posts

Search LinkedIn posts with advanced filters. Description: Search LinkedIn posts Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
countinteger✅ Yes-Max result countMax: 1000
keywordsstring❌ Optional""Any keyword for searching in the post. For exact search put desired keywords into brackets-
sortstring❌ Optional”relevance”Sort type-
date_postedstring❌ Optional”past-month”Date posted filter-
content_typestring❌ Optional-Desired content type-
mentionedstring❌ Optional-Mentioned users URN in posts-
authorsstring❌ Optional-Authors URN of posts-
author_industriesstring❌ Optional-Industry URN or industry name-
author_titlestring❌ Optional-Author job title-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "keywords": "artificial intelligence",
  "date_posted": "past-week",
  "count": 50
}

get_linkedin_post

Get detailed information about a specific LinkedIn post. Description: Get LinkedIn post Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urnstring✅ Yes-Post URN or slug-
include_all_document_imagesboolean❌ OptionalfalseIf enabled, all document images will be included-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "urn": "urn:li:activity:1234567890"
}

get_linkedin_post_comments

Get comments from a LinkedIn post. Description: Get LinkedIn post comments Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urnstring✅ Yes-Post URN (activity type only)-
countinteger✅ Yes-Max result count-
sortstring❌ Optional”recent”Sort type. Relevance might not return all results-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "urn": "urn:li:activity:1234567890",
  "count": 50
}

get_linkedin_post_reactions

Get reactions from a LinkedIn post. Description: Get LinkedIn post reactions Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urnstring✅ Yes-Post URN (activity type only)-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "urn": "urn:li:activity:1234567890",
  "count": 100
}

get_linkedin_post_reposts

Get reposts of a LinkedIn post. Description: Get LinkedIn post reposts Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urnstring✅ Yes-Post URN (activity type only)-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "urn": "urn:li:activity:1234567890",
  "count": 50
}

Jobs & Groups

Categories: job_search, group

search_linkedin_jobs

Search for job postings on LinkedIn. Description: Search LinkedIn jobs Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
countinteger✅ Yes-Max result countMax: 1000
keywordsstring❌ Optional""Any keyword for searching in the job. For exact search put desired keywords into brackets-
sortstring❌ Optional-Job sorting type-
experience_levelstring❌ Optional-Job experience level-
job_typesstring❌ Optional-Job types-
work_typesstring❌ Optional-Work types-
industrystring❌ Optional-Industry URN-
companystring❌ Optional-Company URN-
locationstring❌ Optional”worldwide”Job location-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "keywords": "python developer",
  "location": "San Francisco",
  "count": 50
}

get_linkedin_group

Get information about a LinkedIn group. Description: Get LinkedIn group information Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
groupstring✅ Yes-Group URN or URL-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "group": "https://www.linkedin.com/groups/123456"
}

Category: google

search_linkedin_google_company

Search for LinkedIn company pages via Google. Description: Find LinkedIn company pages using Google search integration for broader discovery Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
querystring✅ Yes-Search query for company-
countinteger❌ Optional10Max result count-
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "query": "OpenAI",
  "count": 5
}

Profile Details

Category: user

get_linkedin_user_experience

Get work experience history from a LinkedIn profile. Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Profile URL, URN, or username
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "https://www.linkedin.com/in/username"
}

get_linkedin_user_education

Get education history from a LinkedIn profile. Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Profile URL, URN, or username
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "https://www.linkedin.com/in/username"
}

get_linkedin_user_skills

Get skills listed on a LinkedIn profile. Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Profile URL, URN, or username
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "https://www.linkedin.com/in/username"
}

get_linkedin_user_endorsers

Get endorsers for a LinkedIn profile’s skills. Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Profile URL, URN, or username
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "https://www.linkedin.com/in/username"
}

get_linkedin_user_certificates

Get certifications from a LinkedIn profile. Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Profile URL, URN, or username
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "https://www.linkedin.com/in/username"
}

get_linkedin_user_honors

Get honors and awards from a LinkedIn profile. Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Profile URL, URN, or username
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "https://www.linkedin.com/in/username"
}

get_linkedin_user_languages

Get languages listed on a LinkedIn profile. Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Profile URL, URN, or username
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "https://www.linkedin.com/in/username"
}

get_linkedin_user_patents

Get patents listed on a LinkedIn profile. Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Profile URL, URN, or username
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "https://www.linkedin.com/in/username"
}

Instagram

Source: instagram | Categories: post, search, user

Posts & Content

Category: post

get_instagram_post

Get detailed information about an Instagram post. Description: Get Instagram post by ID Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
poststring✅ Yes-Post ID-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "post": "CxOTF-..."
}

get_instagram_post_comments

Get comments from an Instagram post. Description: Get Instagram post comments Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
poststring✅ Yes-Post ID-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "post": "CxOTF-...",
  "count": 50
}

get_instagram_post_likes

Get likes from an Instagram post. Description: Get Instagram post likes Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
poststring✅ Yes-Post ID-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "post": "CxOTF-...",
  "count": 100
}

search_instagram_posts

Category: search Search Instagram posts by query. Description: Search Instagram posts Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
querystring✅ Yes-Search query-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "query": "nature photography",
  "count": 50
}

User Profiles

Category: user

get_instagram_user

Get Instagram user profile information. Description: Get Instagram user profile Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
userstring✅ Yes-User ID, alias or URL-
with_creation_dateboolean❌ OptionalfalseSet to true if you need to get account creation date-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "user": "natgeo",
  "with_creation_date": true
}

get_instagram_user_friendships

Get followers or following list from Instagram user. Description: Get Instagram user friendships Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
userstring✅ Yes-User ID, alias or URL-
countinteger✅ Yes-Max result count-
typestring✅ Yes-Type of relationships to fetch (followers/following)-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "user": "natgeo",
  "count": 100,
  "type": "followers"
}

get_instagram_user_posts

Get posts from an Instagram user profile. Description: Get Instagram user posts Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
userstring✅ Yes-User ID, alias or URL-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "user": "natgeo",
  "count": 20
}

get_instagram_user_reels

Get reels from an Instagram user profile. Description: Get Instagram user reels Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
userstring✅ Yes-User ID, alias or URL-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "user": "natgeo",
  "count": 10
}

Twitter/X

Source: twitter | Categories: search, user, user_tweets

Search & Discovery

Category: search

search_twitter_posts

Search Twitter/X posts with advanced filtering. Description: Search Twitter posts Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
countinteger✅ Yes-Max result count-
querystring❌ Optional""Main search query. Can include special operators like from:user, to:user, #hashtag-
exact_phrasestring❌ Optional""Exact phrase (in quotes). Will be added as “phrase” to the query-
any_of_these_wordsstring❌ Optional-Any of these words (OR condition)-
none_of_these_wordsstring❌ Optional-None of these words (NOT condition)-
these_hashtagsstring❌ Optional-These hashtags-
languagestring❌ Optional-Language of tweets-
from_these_accountsstring❌ Optional-From these accounts-
to_these_accountsstring❌ Optional-To these accounts-
mentioning_these_accountsstring❌ Optional-Mentioning these accounts (username with @)-
min_repliesstring❌ Optional-Minimum number of replies-
min_likesstring❌ Optional-Minimum number of likes-
min_retweetsstring❌ Optional-Minimum number of retweets-
from_datestring❌ Optional-Starting date for tweets search (timestamp)-
to_datestring❌ Optional-Ending date for tweets search (timestamp)-
search_typestring❌ Optional”Top”Type of search results-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "query": "artificial intelligence",
  "min_likes": "100",
  "count": 50
}

search_twitter_users

Search Twitter/X users. Description: Search Twitter users Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
countinteger✅ Yes-Max result count-
querystring❌ Optional""Main search users query-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "query": "python developer",
  "count": 20
}

User Data

Category: user

get_twitter_user

Get Twitter/X user profile information. Description: Get Twitter user profile Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
userstring✅ Yes-User Alias or URL-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "user": "elonmusk"
}

get_twitter_user_posts

Get posts from a Twitter/X user. Description: Get Twitter user posts Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
userstring✅ Yes-User ID, alias or URL-
countinteger✅ Yes-Max result count-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "user": "elonmusk",
  "count": 20
}

get_twitter_user_tweets

Get tweets from a Twitter/X user (alternative endpoint). Description: Get Twitter user tweets with extended data Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
userstring✅ Yes-User ID, alias or URL-
countinteger❌ Optional10Max result count-
timeoutinteger❌ Optional300Request timeout in secondsMin: 20, Max: 1500
Example:
{
  "user": "elonmusk",
  "count": 20
}

Reddit

Source: reddit | Categories: search, posts, user

Search & Content

Category: search

search_reddit_posts

Search Reddit posts across all subreddits. Description: Search Reddit posts Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
querystring✅ Yes-Main search query-
countinteger✅ Yes-Max result count-
sortstring❌ Optional”relevance”Type of search results sorting-
time_filterstring❌ Optional”all”Time filter for search results-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "query": "machine learning",
  "sort": "relevance",
  "time_filter": "week",
  "count": 50
}

get_reddit_post

Get detailed information about a Reddit post. Description: Get Reddit post details Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
post_urlstring✅ Yes-Reddit post URL or path (e.g., /r/DogAdvice/comments/1o2g2pq/title/ or full URL)-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "post_url": "https://www.reddit.com/r/Python/comments/..."
}

get_reddit_post_comments

Get comments from a Reddit post. Description: Get Reddit post comments Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
post_urlstring✅ Yes-Reddit post URL or path-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "post_url": "https://www.reddit.com/r/Python/comments/..."
}

User Data

Category: user

get_reddit_user_posts

Get posts by a Reddit user. Description: Get Reddit user’s post history Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Reddit username or URL
countinteger❌ Optional10Max result count
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "spez",
  "count": 20
}

get_reddit_user_comments

Get comments by a Reddit user. Description: Get Reddit user’s comment history Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Reddit username or URL
countinteger❌ Optional10Max result count
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "spez",
  "count": 20
}

get_reddit_user

Get Reddit user profile information. Description: Get Reddit user profile data Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Reddit username or URL
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "spez"
}

get_reddit_user_comments_extended

Get extended comment data for a Reddit user. Description: Get Reddit user comments with additional metadata Parameters:
ParameterTypeRequiredDefaultDescription
userstring✅ Yes-Reddit username or URL
countinteger❌ Optional10Max result count
timeoutinteger❌ Optional300Request timeout in seconds
Example:
{
  "user": "spez",
  "count": 20
}

Web Parser

Source: webparser | Categories: parse, sitemap

Page Extraction

Category: parse

parse_webpage

Parse and extract content from any webpage with flexible filtering options. Description: Parse and extract content from a webpage with flexible filtering options Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urlstring✅ Yes-URL of the page to parse-
include_tagsarray[string]❌ Optional-CSS selectors of elements to include (keep only these)-
exclude_tagsarray[string]❌ Optional-CSS selectors or wildcard masks of elements to exclude. Examples: ‘.sidebar’, ‘promo-
only_main_contentboolean❌ OptionalfalseExtract only main content of the page (heuristic algorithm)-
remove_commentsboolean❌ OptionaltrueRemove HTML comments-
resolve_srcsetboolean❌ OptionaltrueConvert image srcset to src (selects the largest image)-
return_full_htmlboolean❌ OptionalfalseReturn full HTML document (True) or only body content (False)-
min_text_blockinteger❌ Optional200Minimum text block size for main content detection (in characters)-
remove_base64_imagesboolean❌ OptionaltrueRemove base64-encoded images (reduces output size)-
strip_all_tagsboolean❌ OptionalfalseRemove all HTML tags and return plain text only-
extract_contactsboolean❌ OptionalfalseExtract links, emails, and phone numbers from the page-
same_origin_linksboolean❌ OptionalfalseOnly extract links from the same domain (used with extract_contacts)-
social_links_onlyboolean❌ OptionalfalseOnly extract social media links (LinkedIn, Twitter/X, Facebook, Instagram, etc.)-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "url": "https://example.com/article",
  "only_main_content": true,
  "strip_all_tags": true,
  "extract_contacts": true
}
Use Cases:
  • Article content extraction
  • Contact information gathering
  • Social media link discovery
  • Web scraping and data collection

get_sitemap

Fetch and parse website sitemap with filtering options. Description: Fetch and parse website sitemap with filtering options Parameters:
ParameterTypeRequiredDefaultDescriptionConstraints
urlstring✅ Yes-Website URL to fetch sitemap from-
include_patternsarray[string]❌ Optional-Regex patterns for URL paths to include (all URLs if not specified)-
exclude_patternsarray[string]❌ Optional-Regex patterns for URL paths to exclude-
same_host_onlyboolean❌ OptionaltrueOnly include URLs from the same host as the base URL-
respect_robotsboolean❌ OptionaltrueCheck robots.txt and respect disallowed URLs-
countinteger❌ Optional-Maximum number of URLs to return-
return_detailsboolean❌ OptionalfalseReturn detailed sitemap entries (lastmod, changefreq, priority) instead of just URLs-
timeoutinteger❌ Optional300Max scrapping execution timeout (in seconds)Min: 20, Max: 1500
Example:
{
  "url": "https://example.com",
  "count": 100,
  "return_details": true
}
Use Cases:
  • Website structure analysis
  • Content inventory
  • SEO auditing
  • Bulk URL extraction

Other Sources (~50 endpoints)

Amazon, GitHub, Google Maps, Google News, HackerNews, Pinterest, TripAdvisor, and 20+ more — see full list in Overview

Common Parameters

Most endpoints share these common parameters:
ParameterTypeDefaultDescriptionConstraints
timeoutinteger300Maximum execution timeout in secondsMin: 20, Max: 1500
Timeout Best Practices:
  • Use default 300s for most operations
  • Increase to 600-900s for large data extractions
  • Use minimum 20s only for quick tests
  • Maximum 1500s (25 minutes) for very large datasets

LinkedIn URN Format

Many LinkedIn endpoints require URN (Uniform Resource Name) identifiers. URNs can be obtained through search endpoints.
URN Types:
  • Profile URN: urn:li:fsd_profile:ACoAAABCDEF
    • Obtained from: search_linkedin_users, get_linkedin_profile
  • Company URN: urn:li:company:1234
    • Obtained from: search_linkedin_companies, get_linkedin_company
  • Activity URN (Posts): urn:li:activity:1234567890
    • Obtained from: search_linkedin_posts, get_linkedin_user_posts
Getting URNs:
  1. Search for resource using appropriate search tool
  2. Extract URN from search results
  3. Use URN in subsequent data extraction endpoints
Example workflow:
1. search_linkedin_users → get profile URN
2. get_linkedin_user_posts → get post URNs
3. get_linkedin_post_comments → get comments using post URN

Best Practices

Rate Limiting

Respect Limits

Monitor your API usage to stay within quota limits. Use count parameters wisely.

Batch Operations

Combine multiple operations where possible instead of making separate calls.

Timeout Management

Set appropriate timeouts based on expected data volume. Don’t use maximum timeout unnecessarily.

Error Handling

Implement proper error handling and retry logic for production use.

Data Extraction

Do:
  • Start with discover() to find available endpoints, then use search endpoints to find relevant resources
  • Extract only needed data using optional parameters
  • Use filters to narrow results
  • Set reasonable count limits
Don’t:
  • Extract all available data if not needed
  • Make redundant API calls
  • Ignore pagination options
  • Use maximum counts by default
  • Always obtain URNs through search endpoints first
  • Use optional boolean parameters (with_experience, with_skills) to control data volume
  • Leverage location/industry URN filters for precise targeting
  • Use keywords with brackets for exact match: "[software engineer]"
  • User identifiers can be usernames, URLs, or IDs
  • For historical data, use timestamp filters where available
  • Post IDs are platform-specific formats
  • Consider engagement metrics for content analysis
  • Use only_main_content=true for article extraction
  • Leverage exclude_tags to remove ads/navigation
  • Enable extract_contacts for lead generation
  • Set strip_all_tags=true for plain text output

Security

  • Never commit API keys or credentials to version control
  • Use environment variables for sensitive data
  • Monitor API usage regularly
  • Rotate keys periodically
  • Follow platform terms of service

Endpoint Statistics

Total Endpoints: 115+ MCP Tools: 5 meta-tools (discover, execute, get_page, query_cache, export_data) By Platform:
  • LinkedIn: 31 endpoints — Most comprehensive (profiles, companies, posts, skills, experience)
  • Instagram: 8 endpoints
  • Twitter/X: 5 endpoints
  • Reddit: 7 endpoints
  • Y Combinator: 3 endpoints
  • YouTube: 5 endpoints
  • SEC: 2 endpoints
  • Web Parser: 2 endpoints
  • DuckDuckGo: 1 endpoint
  • Other Sources: ~50 endpoints across 30+ sources
By Category:
  • Search & Discovery: 20+ endpoints (includes YC, YouTube, SEC, Google search)
  • User Profiles & Details: 20+ endpoints (profiles, skills, experience, education, certificates)
  • Content & Posts: 17 endpoints (includes video content)
  • Comments & Engagement: 9 endpoints
  • Company Data: 7 endpoints (includes YC companies, SEC filings)
  • Document Extraction: 3 endpoints (SEC documents, YouTube subtitles)
  • Web Parsing: 2 endpoints
  • Other: 30+ endpoints (enterprise partners, marketplaces, news)

Usage Examples

LinkedIn Research Workflow (with query_cache)

1. discover("linkedin", "search")
   → Get available search endpoints and parameters

2. execute("linkedin", "search", "search_users", {keywords: "CTO", location: "San Francisco", count: 50})
   → Get list of CTOs in SF + cache_key

3. query_cache(cache_key, conditions=[{field: "followers", op: ">", value: 1000}])
   → Filter only profiles with 1000+ followers (without loading all 50 into context)

4. execute("linkedin", "user", "get", {user: profile_url})
   → Extract detailed profile information

5. export_data(cache_key, "csv")
   → Download full search results as CSV

Instagram Influencer Analysis

1. execute("instagram", "user", "get", {user: "username"})
   → Get profile metrics

2. execute("instagram", "user", "posts", {user: "username", count: 20})
   → Extract recent posts + cache_key

3. query_cache(cache_key, aggregate={field: "likes", op: "avg"})
   → Calculate average likes per post (server-side)

4. query_cache(cache_key, sort_by="likes", sort_order="desc", limit=5)
   → Get top 5 posts by engagement

Reddit Content Monitoring

1. execute("reddit", "search", "search_posts", {query: "product name", time_filter: "week"})
   → Find relevant discussions + cache_key

2. query_cache(cache_key, sort_by="score", sort_order="desc", limit=10)
   → Get top 10 posts by score

3. execute("reddit", "posts", "get_comments", {post_url: url})
   → Extract all comments

YouTube Video Research

1. execute("youtube", "search", "search_videos", {query: "AI tutorial", count: 50})
   → Find relevant videos + cache_key

2. query_cache(cache_key, sort_by="view_count", sort_order="desc", limit=10)
   → Top 10 by views

3. execute("youtube", "video", "get_subtitles", {video: "video_id", lang: "en"})
   → Get full video transcript

SEC Financial Analysis

1. execute("sec", "search", "search_companies", {entity_name: "Tesla", forms: ["10-K", "10-Q"]})
   → Find recent financial filings

2. execute("sec", "document", "get", {document_url: filing_url})
   → Retrieve full 10-K report

Need Help?

Documentation

Comprehensive guides and tutorials

API Reference

Full REST API documentation

MCP Integration

Setup guides for different clients

Support

Contact our support team