ConnectSafely API Reference

Welcome to the ConnectSafely API documentation. Our REST API enables you to automate LinkedIn interactions programmatically, including messaging, connection requests, post engagement, and profile management.

Overview

The ConnectSafely API provides a comprehensive set of endpoints for LinkedIn automation, allowing you to:

• Automate Outreach: Send personalized messages, connection requests, and follow actions
• Engage with Content: React to posts, comment, and monitor conversations
• Discover Opportunities: Search posts, scrape content, and fetch profile information
• Manage Relationships: Check connection status and manage your LinkedIn network

Getting Started

Base URL

All API requests should be made to:

https://api.connectsafely.ai

Authentication

All endpoints require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer <your_api_key>

You can obtain your API key from the API Key settings in your ConnectSafely dashboard.

Rate Limits

Every limit is per LinkedIn account: calls are spaced about 3 seconds apart, there are per-minute limits by type of call, and LinkedIn actions such as connection requests, messages and comments have daily or weekly limits. When a limit is reached the API returns 429. Responses carry X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers, plus Retry-After when you should wait and retry.

See Rate Limits for every limit and what counts against it.

API Structure

The API is organized into the following categories:

LinkedIn Actions

Automate core LinkedIn interactions including:

• Following/unfollowing profiles
• Sending messages and InMail
• Managing connection requests
• Checking relationship status

LinkedIn Posts

Interact with LinkedIn content:

• Fetch latest posts from profiles
• React and comment on posts
• Search posts by keywords and filters
• Scrape public post content
• Monitor conversations and comments

LinkedIn Profiles

Retrieve LinkedIn profile information:

• Fetch profile details and metadata
• Access profile data programmatically

Endpoints

Browse all 98 endpoints using the navigation sidebar. Each endpoint page includes:

• Live Playground: Test endpoints directly from the documentation
• Code Examples: Ready-to-use snippets in cURL, JavaScript, TypeScript, and Python
• Parameter Documentation: Detailed descriptions of all request parameters
• Response Schemas: Example responses and error codes

OpenAPI Specification

This documentation is generated from our canonical OpenAPI specification available at https://api.connectsafely.ai/linkedin/openapi.json. The specification follows OpenAPI 3.0 and can be used to:

• Generate client libraries in your preferred language
• Import into API testing tools like Postman or Insomnia
• Integrate with API documentation platforms

Support

Need help? Check out our:

• FAQ for common questions
• Documentation for guides and tutorials
• Contact for direct support

Next Steps

1. Get your API key from the dashboard
2. Explore the LinkedIn Actions endpoints
3. Try the live playground on any endpoint page
4. Review the code examples to get started quickly