# Twitter List Lookup Blocks for retrieving information about Twitter/X lists. ## Twitter Get List ### What it is This block retrieves information about a specified Twitter List. ### How it works This block queries the Twitter API v2 to retrieve detailed information about a specific Twitter List by its ID. Returns list metadata including name, description, member count, follower count, and privacy status. The block uses Tweepy with OAuth 2.0 authentication and supports expansions to include owner profile data. Works for both public lists and private lists you own or follow. ### Inputs | Input | Description | Type | Required | | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | -------- | | expansions | Choose what extra information you want to get with your Twitter Lists: - Select 'List\_Owner\_ID' to get details about who owns the list This will let you see more details about the list owner when you also select user fields below. | ListExpansionsFilter | No | | user\_fields | Choose what information you want to see about list owners. This only works when you select 'List\_Owner\_ID' in expansions above. You can see things like: - Their username - Profile picture - Account details - And more | TweetUserFieldsFilter | No | | list\_fields | Choose what information you want to see about the Twitter Lists themselves, such as: - List name - Description - Number of followers - Number of members - Whether it's private - Creation date - And more | ListFieldsFilter | No | | list\_id | The ID of the List to lookup | str | Yes | ### Outputs | Output | Description | Type | | --------------- | ---------------------------------------- | --------------- | | error | Error message if the operation failed | str | | id | ID of the Twitter List | str | | name | Name of the Twitter List | str | | owner\_id | ID of the List owner | str | | owner\_username | Username of the List owner | str | | data | Complete list data | Dict\[str, Any] | | included | Additional data requested via expansions | Dict\[str, Any] | | meta | Metadata about the response | Dict\[str, Any] | ### Possible use case **List Verification**: Verify a list exists and check its current details before performing operations on it. **List Discovery**: Retrieve information about interesting lists to decide whether to follow them. **Analytics Preparation**: Gather list metadata for reporting or analysis purposes. *** ## Twitter Get Owned Lists ### What it is This block retrieves all Lists owned by a specified Twitter user. ### How it works This block queries the Twitter API v2 to retrieve all Twitter Lists created by a specific user. Results include list IDs, names, and detailed metadata with pagination support for users with many lists. The block uses Tweepy with OAuth 2.0 authentication and supports expansions to include owner profile data. Only returns public lists unless querying your own account. ### Inputs | Input | Description | Type | Required | | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | -------- | | expansions | Choose what extra information you want to get with your Twitter Lists: - Select 'List\_Owner\_ID' to get details about who owns the list This will let you see more details about the list owner when you also select user fields below. | ListExpansionsFilter | No | | user\_fields | Choose what information you want to see about list owners. This only works when you select 'List\_Owner\_ID' in expansions above. You can see things like: - Their username - Profile picture - Account details - And more | TweetUserFieldsFilter | No | | list\_fields | Choose what information you want to see about the Twitter Lists themselves, such as: - List name - Description - Number of followers - Number of members - Whether it's private - Creation date - And more | ListFieldsFilter | No | | user\_id | The user ID whose owned Lists to retrieve | str | Yes | | max\_results | Maximum number of results per page (1-100) | int | No | | pagination\_token | Token for pagination | str | No | ### Outputs | Output | Description | Type | | ----------- | ---------------------------------------- | ---------------------- | | error | Error message if the operation failed | str | | list\_ids | List ids of the owned lists | List\[str] | | list\_names | List names of the owned lists | List\[str] | | next\_token | Token for next page of results | str | | data | Complete owned lists data | List\[Dict\[str, Any]] | | included | Additional data requested via expansions | Dict\[str, Any] | | meta | Metadata about the response | Dict\[str, Any] | ### Possible use case **List Discovery**: Find all public lists created by influencers or thought leaders in your industry. **Account Audit**: Review all lists you own to identify ones to update or delete. **Competitive Analysis**: Discover how competitors organize their Twitter following through their public lists. *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://agpt.co/docs/integrations/block-integrations/list_lookup.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.