Limits

Rate limits control how many actions each LinkedIn account can perform per time period. For general Admin API information, see the Admin overview.

Limit categories

CategoryDescription
stPersonProfileViewsStandard LinkedIn profile views
stCompanyPageViewsStandard LinkedIn company page views
stConnectionRequestsConnection requests sent
stMessagesMessages sent
stSearchQueriesLinkedIn search queries
stReactionsPost reactions
stCommentsPost comments
stPostsPosts created
nvPersonProfileViewsSales Navigator profile views
nvCompanyPageViewsSales Navigator company page views
nvMessagesSales Navigator messages

Periods: daily, weekly, monthly

limits.getDefaults

Get the system default limits. These are applied when an account has no custom limits or after resetting to defaults.

bash
curl -X POST https://api.linkedapi.io/admin/limits.getDefaults \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here"

Response:

json
{
  "success": true,
  "result": {
    "limits": [
      {
        "category": "stMessages",
        "period": "daily",
        "maxValue": 50,
        "isEnabled": true
      },
      {
        "category": "stConnectionRequests",
        "period": "daily",
        "maxValue": 10,
        "isEnabled": true
      }
    ]
  }
}

limits.get

Get the current limits for a specific account.

bash
curl -X POST https://api.linkedapi.io/admin/limits.get \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here" \
  -d '{"accountId": "f9b4346a-..."}'

Body:

FieldTypeRequiredDescription
accountIdstringYesAccount UUID

Response:

json
{
  "success": true,
  "result": {
    "limits": [
      {
        "category": "stMessages",
        "period": "daily",
        "maxValue": 25,
        "isEnabled": true
      }
    ]
  }
}

limits.getUsage

Get the current usage against limits for a specific account.

bash
curl -X POST https://api.linkedapi.io/admin/limits.getUsage \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here" \
  -d '{"accountId": "f9b4346a-..."}'

Body:

FieldTypeRequiredDescription
accountIdstringYesAccount UUID

Response:

json
{
  "success": true,
  "result": {
    "usage": [
      {
        "category": "stMessages",
        "period": "daily",
        "maxValue": 50,
        "currentValue": 12,
        "isEnabled": true
      }
    ]
  }
}
FieldTypeDescription
maxValuenumberMaximum allowed actions
currentValuenumberActions performed in the current period
isEnabledbooleanWhether this limit is enforced

limits.set

Set or update limits for an account. Only the specified limits are created or updated; other limits remain unchanged.

bash
curl -X POST https://api.linkedapi.io/admin/limits.set \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here" \
  -d '{
    "accountId": "f9b4346a-...",
    "limits": [
      {
        "category": "stMessages",
        "period": "daily",
        "maxValue": 25,
        "isEnabled": true
      },
      {
        "category": "stConnectionRequests",
        "period": "weekly",
        "maxValue": 30
      }
    ]
  }'

Body:

FieldTypeRequiredDescription
accountIdstringYesAccount UUID
limitsarrayYesArray of limit configurations
limits[].categorystringYesLimit category (see table above)
limits[].periodstringYesdaily, weekly, or monthly
limits[].maxValuenumberYesMaximum allowed actions (>= 0)
limits[].isEnabledbooleanNoWhether this limit is enforced (default: true)

Response:

json
{
  "success": true,
  "result": {}
}

limits.delete

Remove specific limits from an account. The account will fall back to default behavior for removed limits.

bash
curl -X POST https://api.linkedapi.io/admin/limits.delete \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here" \
  -d '{
    "accountId": "f9b4346a-...",
    "limits": [
      {"category": "stMessages", "period": "daily"},
      {"category": "stConnectionRequests", "period": "weekly"}
    ]
  }'

Body:

FieldTypeRequiredDescription
accountIdstringYesAccount UUID
limitsarrayYesArray of limits to remove
limits[].categorystringYesLimit category
limits[].periodstringYesLimit period

Response:

json
{
  "success": true,
  "result": {}
}

limits.resetToDefaults

Reset all limits for an account to the system defaults.

bash
curl -X POST https://api.linkedapi.io/admin/limits.resetToDefaults \
  -H "Content-Type: application/json" \
  -H "linked-api-token: linked_your_token_here" \
  -d '{"accountId": "f9b4346a-..."}'

Body:

FieldTypeRequiredDescription
accountIdstringYesAccount UUID

Response:

json
{
  "success": true,
  "result": {}
}