API Overview
The API is organized into two groups:Watchlists & Engagement
Create watchlists that continuously monitor LinkedIn for keywords, people, and companies. Retrieve AI-categorized posts and automate engagement.
LinkedIn Data
Fetch LinkedIn profiles, get posts, like and comment, direct, on-demand API calls. All endpoints are async with task polling.
Watchlists & Engagement
Create watchlists that continuously scan LinkedIn or Reddit. OutX enriches posts with AI-generated intent labels and relevance scores.One watchlist = one platform. There are four watchlist types, each with its own endpoint: keyword (LinkedIn), Reddit, people (LinkedIn), and company (LinkedIn). Tracking a topic on “LinkedIn and Reddit” means creating two watchlists with two calls. See Choose a watchlist type.
Keyword Watchlists (LinkedIn)
Track LinkedIn posts that match your keywords or an AI-generated keyword set.Reddit Watchlists
Track Reddit posts and comments that match your keywords or an AI-generated keyword set. The Reddit twin of the keyword watchlist: same body shape, different platform.People Watchlists (LinkedIn)
Track posts and activity from specific LinkedIn profiles.Company Watchlists (LinkedIn)
Monitor LinkedIn company pages and their posts.Posts and Engagement
Retrieve, like, and comment on posts surfaced by your watchlists.Team & Usage
LinkedIn Data
Fetch profiles, get posts, and engage. No watchlists needed. All LinkedIn Data endpoints are async: submit a request, get a task ID, then poll for results.
See the full LinkedIn Data section for details and quickstart.
Base URL
All API requests should be made to:Authentication
All endpoints require an API key in thex-api-key header:
Prerequisites
Rate Limits
The HTTP API itself has no rate limit, you can read or write to OutX endpoints (watchlists, posts, interactions) as often as you want. What is capped is the LinkedIn-side work those calls trigger: keyword scans, profile fetches, likes, comments. LinkedIn enforces a per-action daily limit on each LinkedIn account, and it counts the same whether the action originated in the OutX dashboard or via the API. For LinkedIn-action calls (/linkedin-agent/*, /api-like, /api-comment) keep combined volume under ~50 calls per hour and spread throughout the day. See Rate Limits for the exact per-action caps and the live usage dashboard.
API calls do not consume OutX credits. Credits apply only to Sales Navigator export and the email finder.
Getting Started
1
Get Your API Key
Visit mentions.outx.ai/api-doc and click “Reveal API Key”
2
Install Chrome Extension
Install the OutX Chrome Extension on at least one team member’s browser
3
Make Your First Request
Follow the Watchlist Quick Start or the LinkedIn Data Quick Start
Need Help?
Watchlist Quick Start
Create your first watchlist and retrieve posts
LinkedIn Data Quick Start
Fetch your first LinkedIn profile in 2 minutes
Use Cases
Common API workflows and patterns
Support
Contact our team for help
Learn More
Frequently Asked Questions
What is the difference between Watchlists and LinkedIn Data endpoints?
What is the difference between Watchlists and LinkedIn Data endpoints?
Watchlists & Engagement endpoints are for ongoing monitoring, you create watchlists (keyword, people, or company) and OutX continuously scans LinkedIn, enriches posts with AI categories and relevance scores. LinkedIn Data endpoints are for on-demand access, fetch a profile, get posts, like or comment as one-off async tasks. Use watchlists for continuous intelligence, and LinkedIn Data for direct lookups or AI agent integrations.
Do I need a paid plan to use the API?
Do I need a paid plan to use the API?
API access is available on all plans, including the free plan. The HTTP API has no rate limit, but LinkedIn-side actions (keyword scans, profile fetches, likes, comments) are capped per LinkedIn account per day. See Rate Limits for the per-action caps.
Do API calls consume my OutX Credits?
Do API calls consume my OutX Credits?
No. API calls (watchlists, posts, engagement, LinkedIn Data, all of it) are unlimited on every paid plan and do not draw down credits. OutX Credits are a separate currency used only for Sales Navigator export and the email finder, where 1 exported lead or 1 verified email = 1 credit. See Pricing & Subscription for credit allocations.
Is there a webhook for real-time notifications?
Is there a webhook for real-time notifications?
OutX does not currently offer webhooks. Use a polling pattern, periodically call
/api-posts with sort_by=recent (the default) to check for new posts. You can also set up Slack notifications through the OutX UI. See the Webhook-Style Monitoring use case.