The OutX API lets you interact with LinkedIn programmatically, monitor keywords, track people and companies, fetch profiles, and automate engagement. All endpoints share the same base URL and authentication.Documentation Index
Fetch the complete documentation index at: https://www.outx.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
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. OutX enriches posts with AI-generated categories and relevance scores.Keyword Watchlists
Track LinkedIn posts that match your keywords or an AI-generated keyword set.| Method | Endpoint | Description | Details |
|---|---|---|---|
| POST | /api-keyword-watchlist | Create a watchlist (direct keywords or prompt) | Open |
| GET | /api-keyword-watchlist | List or fetch a single keyword watchlist | Open |
| PUT | /api-keyword-watchlist | Patch fields, replace keywords/labels, or regenerate from a new prompt | Open |
| DELETE | /api-keyword-watchlist | Delete a keyword watchlist | Open |
People Watchlists
Track posts and activity from specific LinkedIn profiles.Company Watchlists
Monitor LinkedIn company pages and their posts.Posts and Engagement
Retrieve, like, and comment on posts surfaced by your watchlists.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.| Method | Endpoint | Description | Details |
|---|---|---|---|
| POST | /linkedin-agent/fetch-profile | Fetch any LinkedIn profile by slug | Open |
| POST | /linkedin-agent/fetch-profiles-posts | Get posts from specific profiles by URN | Open |
| POST | /linkedin-agent/fetch-company | Fetch a LinkedIn company page | Open |
| POST | /linkedin-agent/fetch-company-posts | Get posts from specific companies | Open |
| POST | /linkedin-agent/search-profiles | Search LinkedIn for profiles by filters | Open |
| POST | /linkedin-agent/fetch-connections | Fetch your 1st-degree connections | Open |
| POST | /linkedin-agent/like-post | Like a LinkedIn post | Open |
| POST | /linkedin-agent/comment-post | Comment on a LinkedIn post | Open |
| POST | /linkedin-agent/send-message | Send a direct message to a 1st-degree connection | Open |
| POST | /linkedin-agent/send-connection-request | Send a connection request | Open |
| GET | /linkedin-agent/get-task-status | Check the result of an async task | Open |
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
Get Your API Key
Visit mentions.outx.ai/api-doc and click “Reveal API Key”
Install Chrome Extension
Install the OutX Chrome Extension on at least one team member’s browser
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_first to check for new posts. You can also set up Slack notifications through the OutX UI. See the Webhook-Style Monitoring use case.
