List Accounts
Retrieve a paginated list of all connected platform accounts
https://api.lobstr.io/v1/accountsThis endpoint retrieves a paginated list of all connected platform accounts (like Twitter, LinkedIn, Facebook) associated with the authenticated user.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Response Structure
total_resultsintegerTotal number of accounts. Example: 2
limitintegerMaximum results per page. Example: 50
pageintegerCurrent page number. Example: 1
total_pagesintegerTotal number of pages. Example: 1
result_fromintegerStarting result index. Example: 1
result_tointegerEnding result index. Example: 3
dataarrayArray of account objects. Example: [...]
nextstring | nullURL for next page (null if last page). Example: null
previousstring | nullURL for previous page (null if first page). Example: null
Account Object Fields
idstringUnique account identifier. Example: "6e5f36d27502ec69fda745ec59ead509"
objectstringAlways "account". Example: "account"
usernamestringPlatform username. Example: "MisterDebugger"
created_atstringAccount creation timestamp (ISO 8601). Example: "2025-02-11T08:28:14Z"
last_synchronization_timestringLast sync timestamp. Example: "2025-02-11T08:28:14Z"
statusstringHTTP status code. Example: "200"
status_code_infostringStatus information. Example: "synchronized"
status_code_descriptionstringHuman-readable status message. Example: "Success!"
typestringAccount type identifier. Example: "facebook-sync"
paramsobjectAccount parameters (default and user-specific). Example: {"default": {}, "user": {}}
Show params.user fields
user.is_probooleanLeboncoin accounts only. true for a professional Leboncoin account, false for a personal one. Absent until the account sends a message or is synchronized again.
updated_atstring | nullLast update timestamp. Example: null
account_type_hashstringAccount type identifier hash. Example: "16f5b7f91e8fc533eab88be973273a02"
squidsarrayArray of squids using this account. Example: []
baseurlstringPlatform base URL. Example: "https://www.facebook.com"
cookiesarrayRequired cookie names for authentication. Example: [{"name": "c_user", "required": true}]
iconstringBase64 encoded platform icon. Example: "<base64 image data>"
primary_colorstringThe platform's brand colour, as a hex code — used to render the account in the dashboard. Example: "#FF9900"
lock_timeinteger | nullUnix timestamp at which a locked account unlocks again, or null when the account is not locked. Example: null
resets_ininteger | nullSeconds until runs paused by a full limit of this account resume (the next free slot), or null when no limit is reached. Example: null
limitsarrayThe account's limits, each over a rolling 24 hours: an action (a profile, a search, a message) frees its slot 24 hours after it was counted, so there is no daily reset. One object per limit. The Leboncoin message sender's batch (messages sent in one go, then a pause) is not a 24-hour limit and stays in params.
Show limit fields
keystringThe limit, as named in params. Example: "profiles"
displaystringIts label. Example: "Profiles per 24h"
maxintegerThe account's limit. Example: 100
used_24hintegerActions counted in the last 24 hours. Example: 53
remainingintegerActions still possible now. Example: 47
next_capacity_atstring | nullWhile the limit is full, when the next slot frees (UTC): runs paused by this limit resume then. null while there is room. Example: null
full_capacity_atstring | nullWhen everything counted now has left the 24 hours (UTC). null when nothing is counted. Example: "2026-11-12T13:35:00Z"
by_hourarrayThe last 24 hours, one item per hour, oldest first. Example: [{"hour": "2026-11-11T13:00:00Z", "count": 53}, ...]
Use this endpoint to check which platform accounts are currently synced and their status before running squids that require authentication.
The squids array shows which squids are currently using each account, helping you manage account usage across your projects.
Check the status_code_info field to identify accounts with expired cookies that need re-synchronization.
Code Examples
curl -X GET "https://api.lobstr.io/v1/accounts" \ -H "Authorization: Token YOUR_API_KEY"
Response
{ "total_results": 2, "limit": 50, "page": 1, "total_pages": 1, "result_from": 1, "result_to": 3, "data": [ { "id": "6e5f36d27502ec69fda745ec59ead509", "object": "account", "username": "MisterDebugger", "created_at": "2025-02-11T08:28:14Z", "last_synchronization_time": "2025-02-11T08:28:14Z", "status": "200", "status_code_info": "synchronized", "status_code_description": "Success!", "type": "facebook-sync", "params": { "default": {}, "user": {} }, "updated_at": null, "account_type_hash": "16f5b7f91e8fc533eab88be973273a02", "squids": [], "baseurl": "https://www.facebook.com", "cookies": [ {"name": "c_user", "required": true}, {"name": "xs", "required": true} ], "icon": "<base64 image data>" }, { "id": "abfeb440ceccdfab974e8d261836c9d6", "object": "account", "username": "MisterDebugger", "created_at": "2025-02-11T08:28:22Z", "last_synchronization_time": "2025-02-11T08:28:22Z", "status": "200", "status_code_info": "synchronized", "status_code_description": "Success!", "type": "twitter-sync", "params": { "default": {}, "user": {} }, "updated_at": null, "account_type_hash": "9853173fc00a940a33d7a420c176ad3b", "squids": [], "baseurl": "https://x.com", "cookies": [ {"name": "auth_token", "required": true}, {"name": "ct0", "required": true} ], "icon": "<base64 image data>" } ], "next": null, "previous": null }
{ "detail": "Invalid token." }