Skip to content
Account

List Account Types

Retrieve available platform account types and their authentication requirements

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/account_types

Some 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 cookies array 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 cookies array 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

Authorizationstringheaderrequired

Your 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.

200
{
  "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
}