Skip to main content
POST
/
v1
/
accounts
Update Account Limits
curl --request POST \
  --url https://api.lobstr.io/v1/accounts \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "account": "<string>",
  "type": "<string>",
  "params": {}
}
'
{
  "params.default": {},
  "params.user": {},
  "params.user.batch.current": 123,
  "params.user.batch.last_batch_at": "<string>",
  "params.user.[attribute].value": 123,
  "params.user.[attribute].timestamp": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

To update account-specific operational limits (like daily profile visits, search limits, or batch size), use this endpoint. The params object contains the updated values for batch size, daily limits per action, or time gaps between batches.

​
Parameter Keys

Param KeyTypeDescription
batchinteger(Optional) Updated batch size per launch. Controls how many actions run per batch
batch_hoursinteger(Optional) Delay in hours between each batch run
[attribute]integer(Optional) Daily limit for the specific attribute like profiles, searches, or messages

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY
​
Content-Type
string
required
Must be application/json. Value: application/json

​
Request Body

​
account
string
required
Account hash to update. Example: "2372242060b59e03ac39f7691765bbf8"
​
type
string
required
Account type identifier. Example: "sales-nav-sync"
​
params
object
required
Object containing limit parameters to update. Example: {"batch": 20, "profiles": 150, "searches": 199, "batch_hours": 2}

​
Response Field Explanations

​
params.default
object
Default account limits for this account type. Example: {...}
​
params.user
object
User-configured limits with current usage tracking. Example: {...}
​
params.user.batch.current
integer
Current batch count. Example: 0
​
params.user.batch.last_batch_at
string
Timestamp of last batch execution. Example: "18/07/2022 21:47:09"
​
params.user.[attribute].value
integer
Current usage count for this attribute today. Example: 0
​
params.user.[attribute].timestamp
integer
Unix timestamp when the daily counter resets. Example: 1716508800
Adjust batch and batch_hours to control how aggressively your account scrapes. Lower values help avoid platform rate limits.
Don’t exceed the max values defined in the account type’s default params. Higher limits may trigger anti-bot measures.
The params.user object tracks real-time usage. Use it to monitor how close you are to daily limits.
Set conservative limits initially and increase gradually based on your account’s health and platform tolerance.

​
Code Examples

curl -X POST "https://api.lobstr.io/v1/accounts" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account": "2372242060b59e03ac39f7691765bbf8",
    "type": "sales-nav-sync",
    "params": {
      "batch": 20,
      "profiles": 150,
      "searches": 199,
      "batch_hours": 2
    }
  }'

​
Response

200
{
  "id": "2372242060b59e03ac39f7691765bbf8",
  "object": "account",
  "username": "user@domain.com",
  "created_at": "2022-06-16T05:26:31Z",
  "last_synchronization_time": "2022-06-17T14:01:08Z",
  "status": "200",
  "status_code_info": "synchronized",
  "status_code_description": "Success!",
  "type": "sales-nav-sync",
  "params": {
    "default": {
      "batch": {
        "max": 20,
        "default": 20,
        "attribute": "profiles",
        "description": "Number of profiles visited per launch"
      },
      "profiles": {
        "max": 150,
        "default": 150,
        "description": "Maximum number of profile requests per day"
      },
      "searches": {
        "max": 200,
        "default": 200,
        "description": "Maximum number of searches per day"
      },
      "batch_hours": {
        "max": 2,
        "default": 2,
        "description": "Hours between each launch during a day"
      }
    },
    "user": {
      "batch": {
        "max": 20,
        "current": 0,
        "default": 20,
        "attribute": "profiles",
        "start_time": null,
        "last_batch_at": "18/07/2022 21:47:09"
      },
      "profiles": {
        "max": 150,
        "value": 0,
        "default": 150,
        "timestamp": 1716508800,
        "start_time": null
      },
      "searches": {
        "max": 199,
        "value": 0,
        "default": 200,
        "timestamp": 1716508800,
        "start_time": null
      },
      "batch_hours": {
        "max": 2,
        "value": 0,
        "default": 2,
        "description": "Hours between each launch during a day"
      }
    }
  },
  "updated_at": "2025-03-20T11:49:01Z",
  "account_type_hash": "cf67cafe03776e796f02a29f29ab2866",
  "squids": [],
  "baseurl": "https://www.linkedin.com",
  "cookies": [
    {"name": "li_at", "required": true},
    {"name": "JSESSIONID", "required": true},
    {"name": "li_a", "required": true}
  ],
  "icon": "<base64 image data>"
}
400
{
  "detail": "Invalid parameters. Check account hash and type."
}
404
{
  "detail": "Account not found."
}