List Account Types
Retrieve available platform account types and their authentication requirements
https://api.lobstr.io/v1/account_typesSome crawlers require user authentication (like Facebook, LinkedIn) through cookies or session tokens. The account_type object describes the required credentials for such modules.
Account Type Fields
| Field | Type | Description |
|---|---|---|
| id | string | Unique identifier of the account type |
| name | string | The technical name of the account type (e.g., facebook-sync) |
| domain | string | Name of the platform or website this account type connects to (e.g., Facebook) |
| baseurl | string | The base URL for the platform's login or data-fetching endpoints |
| cookies | array | A list of cookie names required for authentication. Some cookies may be marked as required or optional |
Notes
- If the
cookiesarray is empty, it means all cookies from the user session are required for authentication. - Required cookies must be provided for the crawler to work. Missing cookies will result in authentication failure.
For implementation, always verify the required cookies in the
cookiesarray when preparing your account object for a run.
Account Limits
Some account types include a params object that defines limits or batch configurations for the crawler when authenticated. These values help control usage and message sending.
Account Limit Parameters
| Parameter | Type | Description |
|---|---|---|
| [attribute] | object | A limit for a specific attribute (e.g., messages, profiles, searches) over a rolling 24 hours: each action frees its slot 24 hours after it was counted |
| batch | object | (Optional) Defines the maximum number of actions per launch based on the attribute (e.g., messages, profiles) |
| batch_hours | object | (Optional) Defines the delay in hours between batch launches during the day |
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Use this endpoint to discover which platforms support authenticated scraping and what credentials they require.
Account types with empty cookies arrays require all session cookies. Use browser dev tools to extract the full cookie set.
Pay attention to the params object for rate limits. Exceeding these limits may result in account suspension on the target platform.
The batch and batch_hours parameters help you avoid triggering anti-bot measures by spacing out requests throughout the day.
Code Examples
curl -X GET "https://api.lobstr.io/v1/account_types" \ -H "Authorization: Token YOUR_API_KEY"
Response
There are 20 account types at the time of writing (Facebook, LinkedIn, Sales Navigator, Twitter/X, Instagram, Leboncoin, and more platform-specific ones). The example below shows 4 for brevity — total_results reflects the real full count.
{ "total_results": 20, "limit": 50, "page": 1, "total_pages": 1, "result_from": 1, "result_to": 20, "data": [ { "id": "16f5b7f91e8fc533eab88be973273a02", "object": "account_type", "name": "facebook-sync", "icon": "<base64 image data>", "domain": "Facebook", "params": {}, "baseurl": "https://www.facebook.com", "cookies": [ {"name": "c_user", "required": true}, {"name": "xs", "required": true} ] }, { "id": "77472acc63e41abde1fa2afd24bece4c", "object": "account_type", "name": "linkedin-sync", "icon": "<base64 image data>", "domain": "Linkedin", "params": { "profiles": { "max": 1000, "default": 800, "display": "Profiles per 24h", "description": "Maximum number of profiles the account can scrape in any 24 hours: each profile frees its slot 24 hours after it was counted. When the limit is reached, runs using this account pause and resume as soon as a slot frees." } }, "baseurl": "https://www.linkedin.com", "cookies": [ {"name": "li_at", "required": true}, {"name": "JSESSIONID", "required": true} ] }, { "id": "cf67cafe03776e796f02a29f29ab2866", "object": "account_type", "name": "sales-nav-sync", "icon": "<base64 image data>", "domain": "Sales Navigator", "params": { "batch": { "max": 20, "default": 20, "attribute": "profiles", "description": "Number of profiles visited per launch" }, "profiles": { "max": 150, "default": 150, "description": "Maximum number of profiles the account can scrape in any 24 hours: each profile frees its slot 24 hours after it was counted." }, "searches": { "max": 200, "default": 200, "description": "Maximum number of searches the account can run in any 24 hours: each search frees its slot 24 hours after it was run." }, "batch_hours": { "max": 2, "default": 2, "description": "Hours between each launch during a day" } }, "baseurl": "https://www.linkedin.com", "cookies": [ {"name": "li_at", "required": true}, {"name": "JSESSIONID", "required": true}, {"name": "li_a", "required": true} ] }, { "id": "9853173fc00a940a33d7a420c176ad3b", "object": "account_type", "name": "twitter-sync", "icon": "<base64 image data>", "domain": "Twitter", "params": {}, "baseurl": "https://x.com", "cookies": [ {"name": "auth_token", "required": true}, {"name": "ct0", "required": true} ] } ], "next": null, "previous": null }