Getting Started with LinkedMash API

Learn how to authenticate and start using the LinkedMash API to access your bookmarks and data.

Authentication

All API requests require authentication using an API key. Follow these steps to get your API key:

Step 1: Visit the API Integration Page

Go to the LinkedMash API integration page to generate an API key.

Open API Integration Page

Step 2: Generate Your API Key

Click the button on the integration page to create a new API key.

Note: Your API key is sensitive information. Keep it secure and never share it publicly.

Step 3: Use Your API Key

Include your API key in the Authorization header for all API requests.

Authorization: Bearer YOUR_API_KEY_HERE

Quick Start Example

Here's a simple example to fetch your bookmarks:

cURL Command:

curl -X GET "https://api.linkedmash.com/v1/bookmarks" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

Response Example:

{
  "status": true,
  "data": [
    {
      "post_id": "7336731872414035968",
      "post_details": {
        "text": "Your post content here...",
        "link": "https://www.linkedin.com/feed/update/urn:li:activity:7336731872414035968",
        "posted_at": "2025-06-06T12:33:08.27+00:00"
      },
      "author_details": {
        "name": "Author Name",
        "username": "username"
      }
    }
  ],
  "meta": {
    "next_cursor": "MTc1OTYxNw==",
    "limit": 20,
    "total_count": 396
  }
}

Rate Limits

API requests are subject to rate limits to ensure fair usage.

✓100 requests per hour per API key

Error Handling

The API returns standard HTTP status codes and error messages.

401 Unauthorized - Invalid or missing API key
402 Subscription Required - Upgrade your plan
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error - Something went wrong

Next Steps

Now that you have your API key, explore the available endpoints:

Bookmarks

Fetch and manage your saved posts with filtering and pagination options.

View Documentation →

Labels

Manage labels for organizing your bookmarks and content.

View Documentation →