Get Account Details
Retrieve detailed information about a specific platform account
https://api.lobstr.io/v1/accounts/{account_hash}This endpoint retrieves detailed information about a specific platform account using its hash ID.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Path Parameters
account_hashstringpathrequiredThe unique identifier (hash) of the account. Example: d3e97f2cd33658f301bdbe807402ab30
Response Field Explanations
idstringUnique account identifier. Example: "d3e97f2cd33658f301bdbe807402ab30"
objectstringAlways "account". Example: "account"
usernamestringPlatform username. Example: "hashamxcom"
created_atstringAccount creation timestamp (ISO 8601). Example: "2024-03-08T15:15:53Z"
last_synchronization_timestringLast successful sync timestamp. Example: "2024-12-16T10:28:43Z"
statusstringHTTP status code indicating account health. Example: "200"
status_code_infostringStatus information keyword. Example: "synchronized"
status_code_descriptionstringHuman-readable status message. Example: "Success!"
typestringAccount type identifier. Example: "twitter-sync"
paramsobjectAccount parameters with default and user-specific settings. 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_hashstringReference to account type definition. Example: "9853173fc00a940a33d7a420c176ad3b"
squidsarrayArray of squids currently using this account. Example: [{"name": "Twitter Scraper", "hash_value": "fcd3..."}]
baseurlstringPlatform base URL. Example: "https://x.com"
cookiesarrayRequired cookie specifications. Example: [{"name": "auth_token", "required": true}]
iconstringBase64 encoded platform icon. Example: "<base64 image data>"
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}, ...]
Check the squids array to see which squids are using this account before deleting or updating it.
Monitor the status field regularly. A status of 429 or 401 indicates cookie expiration and requires re-synchronization.
The params object contains both default limits and current user-configured values, useful for understanding account usage.
Code Examples
curl -X GET "https://api.lobstr.io/v1/accounts/d3e97f2cd33658f301bdbe807402ab30" \ -H "Authorization: Token YOUR_API_KEY"
Response
{ "total_results": 1, "limit": 50, "page": 1, "total_pages": 1, "result_from": 1, "result_to": 2, "data": [ { "id": "d3e97f2cd33658f301bdbe807402ab30", "object": "account", "username": "hashamxcom", "created_at": "2024-03-08T15:15:53Z", "last_synchronization_time": "2024-12-16T10:28:43Z", "status": "200", "status_code_info": "synchronized", "status_code_description": "Success!", "type": "twitter-sync", "params": { "default": {}, "user": {} }, "updated_at": null, "account_type_hash": "9853173fc00a940a33d7a420c176ad3b", "squids": [ { "name": "Twitter User Tweets Scraper (2)", "hash_value": "fcd3fff4053e444b8a98b3660bee8b03" } ], "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." }
{ "detail": "Not found." }