API Docs/Get Started/Introduction
API Reference

Getting Started with LinkedMash API

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

Base URL — all requests go to https://api.linkedmash.com. Include your API key in the Authorization header on every request.

Authentication

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

1

Step 1: Visit the API Integration Page

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

2

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.
3

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
curl -X GET "https://api.linkedmash.com/v1/bookmarks" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

Response Example:

JSON
{
  "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. Use the next_cursor in meta to paginate efficiently.

Error Handling

The API returns standard HTTP status codes and error messages.

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

Next Steps

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