# Discover X Lists an Account Owns or Follows

**Use case:** 

Enter an X username, profile URL, or user ID to find the public Lists that account owns or follows. Export List details, owners, descriptions, member counts, subscriber counts, and direct List URLs.

## Input

```json
{
  "operation": "account_lists",
  "accountListType": "all",
  "screenNames": [
    "https://x.com/TheZvi"
  ],
  "userIds": [],
  "listIds": [],
  "maxListsPerAccount": 20,
  "maxUsersPerList": 100
}
```

## Output

```json
{
  "status": {
    "label": "Status",
    "format": "string"
  },
  "result_type": {
    "label": "Result type",
    "format": "string"
  },
  "operation": {
    "label": "Operation",
    "format": "string"
  },
  "relationship_type": {
    "label": "Relationship",
    "format": "string"
  },
  "requested_identifier": {
    "label": "Requested input",
    "format": "string"
  },
  "source_user_id": {
    "label": "Source user ID",
    "format": "string"
  },
  "source_screen_name": {
    "label": "Source username",
    "format": "string"
  },
  "source_profile_url": {
    "label": "Source profile",
    "format": "string"
  },
  "list_id": {
    "label": "List ID",
    "format": "string"
  },
  "list_name": {
    "label": "List name",
    "format": "string"
  },
  "list_slug": {
    "label": "List slug",
    "format": "string"
  },
  "list_full_name": {
    "label": "List full name",
    "format": "string"
  },
  "list_uri": {
    "label": "List URI",
    "format": "string"
  },
  "list_url": {
    "label": "List URL",
    "format": "string"
  },
  "description": {
    "label": "Description",
    "format": "string"
  },
  "list_visibility": {
    "label": "Visibility",
    "format": "string"
  },
  "created_at": {
    "label": "Created at",
    "format": "string"
  },
  "member_count": {
    "label": "Members",
    "format": "integer"
  },
  "subscriber_count": {
    "label": "Subscribers",
    "format": "integer"
  },
  "owner_user_id": {
    "label": "Owner user ID",
    "format": "string"
  },
  "owner_screen_name": {
    "label": "Owner username",
    "format": "string"
  },
  "owner_name": {
    "label": "Owner name",
    "format": "string"
  },
  "owner_profile_url": {
    "label": "Owner profile",
    "format": "string"
  },
  "owner_description": {
    "label": "Owner bio",
    "format": "string"
  },
  "owner_location": {
    "label": "Owner location",
    "format": "string"
  },
  "owner_website_url": {
    "label": "Owner website",
    "format": "string"
  },
  "owner_account_created_at": {
    "label": "Owner account created at",
    "format": "string"
  },
  "owner_followers_count": {
    "label": "Owner followers",
    "format": "integer"
  },
  "owner_following_count": {
    "label": "Owner following",
    "format": "integer"
  },
  "owner_tweets_count": {
    "label": "Owner posts",
    "format": "integer"
  },
  "owner_media_count": {
    "label": "Owner media",
    "format": "integer"
  },
  "owner_likes_count": {
    "label": "Owner likes",
    "format": "integer"
  },
  "owner_listed_count": {
    "label": "Owner listed count",
    "format": "integer"
  },
  "owner_verified": {
    "label": "Owner verified",
    "format": "boolean"
  },
  "owner_protected": {
    "label": "Owner protected",
    "format": "boolean"
  },
  "owner_profile_image_url": {
    "label": "Owner avatar",
    "format": "string"
  },
  "owner_profile_banner_url": {
    "label": "Owner profile banner",
    "format": "string"
  },
  "owner_pinned_tweet_ids": {
    "label": "Owner pinned post IDs",
    "format": "array"
  },
  "owner_bio_urls": {
    "label": "Owner bio URLs",
    "format": "array"
  },
  "owner_bio_mentions": {
    "label": "Owner bio mentions",
    "format": "array"
  },
  "owner_bio_hashtags": {
    "label": "Owner bio hashtags",
    "format": "array"
  },
  "owner_can_media_tag": {
    "label": "Owner can be media tagged",
    "format": "boolean"
  },
  "owner_geo_enabled": {
    "label": "Owner geo enabled",
    "format": "boolean"
  },
  "owner_default_profile": {
    "label": "Owner default profile",
    "format": "boolean"
  },
  "owner_default_profile_image": {
    "label": "Owner default profile image",
    "format": "boolean"
  },
  "owner_has_extended_profile": {
    "label": "Owner has extended profile",
    "format": "boolean"
  },
  "owner_has_custom_timelines": {
    "label": "Owner has custom timelines",
    "format": "boolean"
  },
  "owner_advertiser_account_type": {
    "label": "Owner advertiser account type",
    "format": "string"
  },
  "owner_business_profile_state": {
    "label": "Owner business profile state",
    "format": "string"
  },
  "owner_withheld_in_countries": {
    "label": "Owner withheld countries",
    "format": "array"
  },
  "owner_translator_type": {
    "label": "Owner translator type",
    "format": "string"
  },
  "owner_lang": {
    "label": "Owner language",
    "format": "string"
  },
  "owner_time_zone": {
    "label": "Owner time zone",
    "format": "string"
  },
  "owner_utc_offset": {
    "label": "Owner UTC offset",
    "format": "integer"
  }
}
```

## About this Actor

This example demonstrates how to use [X / Twitter Lists Scraper — Members & Subscribers](https://apify.com/arjun_code/x-twitter-lists-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/arjun_code/x-twitter-lists-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/arjun_code/x-twitter-lists-scraper.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).