API Reference

Complete API reference for ConnectSafely's LinkedIn automation endpoints.

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

API requests are subject to rate limiting to ensure fair usage. Rate limit information is included in response headers:

  • X-RateLimit-Limit: Maximum number of requests allowed
  • X-RateLimit-Remaining: Number of requests remaining
  • X-RateLimit-Reset: Time when the rate limit resets

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 15 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 located at content/api/openapi.yaml. The specification follows OpenAPI 3.1.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:

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