github/AutoGPT
1
1
Fork 0
mirror of https://github.com/Significant-Gravitas/AutoGPT.git synced 2026-01-09 15:17:59 -05:00
Code Issues Packages Projects Releases Wiki Activity

feat(block) : Todoist rest api blocks (#9369)

Browse Source 
- Resolves - #9303 and #9304
- Depends on - https://github.com/Significant-Gravitas/AutoGPT/pull/9319

### Blocks list

Block Name | What It Does | Manually Tested
-- | -- | --
Todoist Create Label | Creates a new label in Todoist | ✅
Todoist List Labels | Retrieves all personal labels from Todoist | ✅
Todoist Get Label | Retrieves a specific label by ID | ✅
Todoist Create Task | Creates a new task in Todoist | ✅
Todoist Get Tasks | Retrieves active tasks from Todoist | ✅
Todoist Update Task | Updates an existing task | ✅
Todoist Close Task | Completes/closes a task | ✅
Todoist Reopen Task | Reopens a completed task | ✅
Todoist Delete Task | Permanently deletes a task | ✅
Todoist List Projects | Retrieves all projects from Todoist | ✅
Todoist Create Project | Creates a new project in Todoist | ✅
Todoist Get Project | Retrieves details for a specific project | ✅
Todoist Update Project | Updates an existing project | ✅
Todoist Delete Project | Deletes a project and its contents | ✅
Todoist List Collaborators | Retrieves collaborators on a project | ✅
Todoist List Sections | Retrieves sections from Todoist | ✅
Todoist Get Section | Retrieves details for a specific section | ✅
Todoist Delete Section | Deletes a section and its tasks | ✅
Todoist Create Comment | Creates a new comment on a task or project | ✅
Todoist Get Comments | Retrieves all comments for a task or project | ✅
Todoist Get Comment | Retrieves a specific comment by ID | ✅
Todoist Update Comment | Updates an existing comment | ✅
Todoist Delete Comment | Deletes a comment | ✅

> I’ve only created action blocks in Todoist because webhooks can only
be manually created [we can't do it programatically right now]. I’ve
already emailed Todoist for help, but they haven’t replied yet. Once I
receive a reply, I’ll create a pull request for webhook triggers in
Todoist.
This commit is contained in:
Abhimanyu Yadav
2025-01-30 19:03:29 +05:30
committed by GitHub
parent bd27ce5f26
commit a44c9333d3
21 changed files with 3673 additions and 136 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
docs/content/platform/blocks/blocks.md
View File

@@ -134,7 +134,7 @@ Below is a comprehensive list of all available blocks, categorized by their prim
|------------|-------------|
| [Twitter Post Tweet](twitter/twitter.md#twitter-post-tweet-block) | Creates a tweet on Twitter with text content and optional attachments including media, polls, quotes, or deep links |
| [Twitter Delete Tweet](twitter/twitter.md#twitter-delete-tweet-block) | Deletes a specified tweet using its tweet ID |
| [Twitter Search Recent](twitter/twitter.md#twitter-search-recent-block) | Searches for tweets matching specified criteria with options for filtering and pagination |
| [Twitter Search Recent Tweets](twitter/twitter.md#twitter-search-recent-tweets-block) | Searches for tweets matching specified criteria with options for filtering and pagination |
| [Twitter Get Quote Tweets](twitter/twitter.md#twitter-get-quote-tweets-block) | Gets tweets that quote a specified tweet ID with options for pagination and filtering |
| [Twitter Retweet](twitter/twitter.md#twitter-retweet-block) | Creates a retweet of a specified tweet using its tweet ID |
| [Twitter Remove Retweet](twitter/twitter.md#twitter-remove-retweet-block) | Removes an existing retweet of a specified tweet |
@@ -167,4 +167,31 @@ Below is a comprehensive list of all available blocks, categorized by their prim
| Twitter Send Direct Message | Working... Sends a direct message to a specified user |
| Twitter Create DM Conversation | Working... Creates a new direct message conversation |
## Todoist Integration
| Block Name | Description |
|------------|-------------|
| [Todoist Create Label](todoist.md#todoist-create-label) | Creates a new label in Todoist |
| [Todoist List Labels](todoist.md#todoist-list-labels) | Retrieves all personal labels from Todoist |
| [Todoist Get Label](todoist.md#todoist-get-label) | Retrieves a specific label by ID |
| [Todoist Create Task](todoist.md#todoist-create-task) | Creates a new task in Todoist |
| [Todoist Get Tasks](todoist.md#todoist-get-tasks) | Retrieves active tasks from Todoist |
| [Todoist Update Task](todoist.md#todoist-update-task) | Updates an existing task |
| [Todoist Close Task](todoist.md#todoist-close-task) | Completes/closes a task |
| [Todoist Reopen Task](todoist.md#todoist-reopen-task) | Reopens a completed task |
| [Todoist Delete Task](todoist.md#todoist-delete-task) | Permanently deletes a task |
| [Todoist List Projects](todoist.md#todoist-list-projects) | Retrieves all projects from Todoist |
| [Todoist Create Project](todoist.md#todoist-create-project) | Creates a new project in Todoist |
| [Todoist Get Project](todoist.md#todoist-get-project) | Retrieves details for a specific project |
| [Todoist Update Project](todoist.md#todoist-update-project) | Updates an existing project |
| [Todoist Delete Project](todoist.md#todoist-delete-project) | Deletes a project and its contents |
| [Todoist List Collaborators](todoist.md#todoist-list-collaborators) | Retrieves collaborators on a project |
| [Todoist List Sections](todoist.md#todoist-list-sections) | Retrieves sections from Todoist |
| [Todoist Get Section](todoist.md#todoist-get-section) | Retrieves details for a specific section |
| [Todoist Delete Section](todoist.md#todoist-delete-section) | Deletes a section and its tasks |
| [Todoist Create Comment](todoist.md#todoist-create-comment) | Creates a new comment on a task or project |
| [Todoist Get Comments](todoist.md#todoist-get-comments) | Retrieves all comments for a task or project |
| [Todoist Get Comment](todoist.md#todoist-get-comment) | Retrieves a specific comment by ID |
| [Todoist Update Comment](todoist.md#todoist-update-comment) | Updates an existing comment |
| [Todoist Delete Comment](todoist.md#todoist-delete-comment) | Deletes a comment |
This comprehensive list covers all the blocks available in AutoGPT. Each block is designed to perform a specific task, and they can be combined to create powerful, automated workflows. For more detailed information on each block, click on its name to view the full documentation.

722
docs/content/platform/blocks/todoist.md Normal file
View File

@@ -0,0 +1,722 @@
# Todoist Blocks
## Todoist Create Label
### What it is
A block that creates a new label in Todoist.
### What it does
Creates a new label in Todoist with specified name, order, color and favorite status.
### How it works
It takes label details as input, connects to Todoist API, creates the label and returns the created label's details.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Name | Name of the label |
| Order | Optional label order |
| Color | Optional color of the label icon |
| Is Favorite | Whether label is marked as favorite |
### Outputs
| Output | Description |
|--------|-------------|
| ID | ID of the created label |
| Name | Name of the label |
| Color | Color of the label |
| Order | Label order |
| Is Favorite | Favorite status |
| Error | Error message if request failed |
### Possible use case
Creating new labels to organize and categorize tasks in Todoist.
---
## Todoist List Labels
### What it is
A block that retrieves all personal labels from Todoist.
### What it does
Fetches all personal labels from the user's Todoist account.
### How it works
Connects to Todoist API using provided credentials and retrieves all labels.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
### Outputs
| Output | Description |
|--------|-------------|
| Labels | List of complete label data |
| Label IDs | List of label IDs |
| Label Names | List of label names |
| Error | Error message if request failed |
### Possible use case
Getting an overview of all labels to organize tasks or find specific labels.
---
## Todoist Get Label
### What it is
A block that retrieves a specific label by ID.
### What it does
Fetches details of a specific label using its ID.
### How it works
Uses the label ID to retrieve label details from Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Label ID | ID of label to retrieve |
### Outputs
| Output | Description |
|--------|-------------|
| ID | Label ID |
| Name | Label name |
| Color | Label color |
| Order | Label order |
| Is Favorite | Favorite status |
| Error | Error message if request failed |
### Possible use case
Looking up details of a specific label for editing or verification.
---
## Todoist Create Task
### What it is
A block that creates a new task in Todoist.
### What it does
Creates a new task with specified content, description, project assignment and other optional parameters.
### How it works
Takes task details and creates a new task via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Content | Task content |
| Description | Optional task description |
| Project ID | Optional project to add task to |
| Section ID | Optional section to add task to |
| Parent ID | Optional parent task ID |
| Order | Optional task order |
| Labels | Optional task labels |
| Priority | Optional priority (1-4) |
| Due Date | Optional due date |
| Deadline Date | Optional deadline date |
| Assignee ID | Optional assignee |
| Duration Unit | Optional duration unit |
| Duration | Optional duration amount |
### Outputs
| Output | Description |
|--------|-------------|
| ID | Created task ID |
| URL | Task URL |
| Complete Data | Complete task data |
| Error | Error message if request failed |
### Possible use case
Creating new tasks with full customization of parameters.
---
## Todoist Get Tasks
### What it is
A block that retrieves active tasks from Todoist.
### What it does
Fetches tasks based on optional filters like project, section, label etc.
### How it works
Queries Todoist API with provided filters to get matching tasks.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Project ID | Optional filter by project |
| Section ID | Optional filter by section |
| Label | Optional filter by label |
| Filter | Optional custom filter string |
| Lang | Optional filter language |
| IDs | Optional specific task IDs |
### Outputs
| Output | Description |
|--------|-------------|
| IDs | List of task IDs |
| URLs | List of task URLs |
| Complete Data | Complete task data |
| Error | Error message if request failed |
### Possible use case
Retrieving tasks matching specific criteria for review or processing.
---
## Todoist Update Task
### What it is
A block that updates an existing task.
### What it does
Updates specified fields of an existing task.
### How it works
Takes task ID and updated fields, applies changes via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Task ID | ID of task to update |
| Content | New task content |
| Description | New description |
| Project ID | New project ID |
| Section ID | New section ID |
| Parent ID | New parent task ID |
| Order | New order |
| Labels | New labels |
| Priority | New priority |
| Due Date | New due date |
| Deadline Date | New deadline date |
| Assignee ID | New assignee |
| Duration Unit | New duration unit |
| Duration | New duration |
### Outputs
| Output | Description |
|--------|-------------|
| Success | Whether update succeeded |
| Error | Error message if failed |
### Possible use case
Modifying task details like due dates, priority etc.
---
## Todoist Close Task
### What it is
A block that completes/closes a task.
### What it does
Marks a task as complete in Todoist.
### How it works
Uses task ID to mark it complete via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Task ID | ID of task to close |
### Outputs
| Output | Description |
|--------|-------------|
| Success | Whether task was closed |
| Error | Error message if failed |
### Possible use case
Marking tasks as done in automated workflows.
---
## Todoist Reopen Task
### What it is
A block that reopens a completed task.
### What it does
Marks a completed task as active again.
### How it works
Uses task ID to reactivate via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Task ID | ID of task to reopen |
### Outputs
| Output | Description |
|--------|-------------|
| Success | Whether task was reopened |
| Error | Error message if failed |
### Possible use case
Reactivating tasks that were closed accidentally or need to be repeated.
---
## Todoist Delete Task
### What it is
A block that permanently deletes a task.
### What it does
Removes a task completely from Todoist.
### How it works
Uses task ID to delete via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Task ID | ID of task to delete |
### Outputs
| Output | Description |
|--------|-------------|
| Success | Whether deletion succeeded |
| Error | Error message if failed |
### Possible use case
Removing unwanted or obsolete tasks from the system.
---
## Todoist List Projects
### What it is
A block that retrieves all projects from Todoist.
### What it does
Fetches all projects and their details from a user's Todoist account.
### How it works
Connects to Todoist API using provided credentials and retrieves all projects.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
### Outputs
| Output | Description |
|--------|-------------|
| Names List | List of project names |
| IDs List | List of project IDs |
| URL List | List of project URLs |
| Complete Data | Complete project data |
| Error | Error message if request failed |
### Possible use case
Getting an overview of all projects for organization or automation.
---
## Todoist Create Project
### What it is
A block that creates a new project in Todoist.
### What it does
Creates a new project with specified name, parent project, color and other settings.
### How it works
Takes project details and creates via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Name | Name of the project |
| Parent ID | Optional parent project ID |
| Color | Optional color of project icon |
| Is Favorite | Whether project is favorite |
| View Style | Display style (list/board) |
### Outputs
| Output | Description |
|--------|-------------|
| Success | Whether creation succeeded |
| Error | Error message if failed |
### Possible use case
Creating new projects programmatically for workflow automation.
---
## Todoist Get Project
### What it is
A block that retrieves details for a specific project.
### What it does
Fetches complete details of a single project by ID.
### How it works
Uses project ID to retrieve details via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Project ID | ID of project to get |
### Outputs
| Output | Description |
|--------|-------------|
| Project ID | ID of the project |
| Project Name | Name of the project |
| Project URL | URL of the project |
| Complete Data | Complete project data |
| Error | Error message if failed |
### Possible use case
Looking up project details for verification or editing.
---
## Todoist Update Project
### What it is
A block that updates an existing project.
### What it does
Updates specified fields of an existing project.
### How it works
Takes project ID and updated fields, applies via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Project ID | ID of project to update |
| Name | New project name |
| Color | New color for icon |
| Is Favorite | New favorite status |
| View Style | New display style |
### Outputs
| Output | Description |
|--------|-------------|
| Success | Whether update succeeded |
| Error | Error message if failed |
### Possible use case
Modifying project settings or reorganizing projects.
---
## Todoist Delete Project
### What it is
A block that deletes a project and its contents.
### What it does
Permanently removes a project including sections and tasks.
### How it works
Uses project ID to delete via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Project ID | ID of project to delete |
### Outputs
| Output | Description |
|--------|-------------|
| Success | Whether deletion succeeded |
| Error | Error message if failed |
### Possible use case
Removing completed or obsolete projects.
---
## Todoist List Collaborators
### What it is
A block that retrieves collaborators on a project.
### What it does
Fetches all collaborators and their details for a specific project.
### How it works
Uses project ID to get collaborator list via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Project ID | ID of project to check |
### Outputs
| Output | Description |
|--------|-------------|
| Collaborator IDs | List of collaborator IDs |
| Collaborator Names | List of collaborator names |
| Collaborator Emails | List of collaborator emails |
| Complete Data | Complete collaborator data |
| Error | Error message if failed |
### Possible use case
Managing project sharing and collaboration.
---
## Todoist List Sections
### What it is
A block that retrieves sections from Todoist.
### What it does
Fetches all sections, optionally filtered by project.
### How it works
Connects to Todoist API to retrieve sections list.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Project ID | Optional project filter |
### Outputs
| Output | Description |
|--------|-------------|
| Names List | List of section names |
| IDs List | List of section IDs |
| Complete Data | Complete section data |
| Error | Error message if failed |
### Possible use case
Getting section information for task organization.
---
## Todoist Get Section
### What it is
A block that retrieves details for a specific section.
### What it does
Fetches complete details of a single section by ID.
### How it works
Uses section ID to retrieve details via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Section ID | ID of section to get |
### Outputs
| Output | Description |
|--------|-------------|
| ID | Section ID |
| Project ID | Parent project ID |
| Order | Section order |
| Name | Section name |
| Error | Error message if failed |
### Possible use case
Looking up section details for task management.
---
## Todoist Delete Section
### What it is
A block that deletes a section and its tasks.
### What it does
Permanently removes a section including all tasks.
### How it works
Uses section ID to delete via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Section ID | ID of section to delete |
### Outputs
| Output | Description |
|--------|-------------|
| Success | Whether deletion succeeded |
| Error | Error message if failed |
### Possible use case
Removing unused sections or reorganizing projects.
---
## Todoist Create Comment
### What it is
A block that creates a new comment on a Todoist task or project.
### What it does
Creates a comment with specified content on either a task or project.
### How it works
Takes comment content and task/project ID, creates comment via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Content | Comment content |
| ID Type | Task ID or Project ID to comment on |
| Attachment | Optional file attachment |
### Outputs
| Output | Description |
|--------|-------------|
| ID | ID of created comment |
| Content | Comment content |
| Posted At | Comment timestamp |
| Task ID | Associated task ID |
| Project ID | Associated project ID |
| Error | Error message if request failed |
### Possible use case
Adding notes and comments to tasks or projects automatically.
---
## Todoist Get Comments
### What it is
A block that retrieves all comments for a task or project.
### What it does
Fetches all comments associated with a specific task or project.
### How it works
Uses task/project ID to get comments list via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| ID Type | Task ID or Project ID to get comments for |
### Outputs
| Output | Description |
|--------|-------------|
| Comments | List of comments |
| Error | Error message if request failed |
### Possible use case
Reviewing comment history on tasks or projects.
---
## Todoist Get Comment
### What it is
A block that retrieves a specific comment by ID.
### What it does
Fetches details of a single comment using its ID.
### How it works
Uses comment ID to retrieve details via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Comment ID | ID of comment to retrieve |
### Outputs
| Output | Description |
|--------|-------------|
| Content | Comment content |
| ID | Comment ID |
| Posted At | Comment timestamp |
| Project ID | Associated project ID |
| Task ID | Associated task ID |
| Attachment | Optional file attachment |
| Error | Error message if request failed |
### Possible use case
Looking up specific comment details for reference.
---
## Todoist Update Comment
### What it is
A block that updates an existing comment.
### What it does
Updates the content of a specific comment.
### How it works
Takes comment ID and new content, updates via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Comment ID | ID of comment to update |
| Content | New content for the comment |
### Outputs
| Output | Description |
|--------|-------------|
| Success | Whether update succeeded |
| Error | Error message if request failed |
### Possible use case
Modifying existing comments to fix errors or update information.
---
## Todoist Delete Comment
### What it is
A block that deletes a comment.
### What it does
Permanently removes a comment from a task or project.
### How it works
Uses comment ID to delete via Todoist API.
### Inputs
| Input | Description |
|-------|-------------|
| Credentials | Todoist API credentials |
| Comment ID | ID of comment to delete |
### Outputs
| Output | Description |
|--------|-------------|
| Success | Whether deletion succeeded |
| Error | Error message if request failed |
### Possible use case
Removing outdated or incorrect comments from tasks/projects.

321
docs/content/platform/blocks/twitter/twitter.md
View File

@@ -122,22 +122,22 @@ It uses the Twitter API (Tweepy) to fetch quote tweets for a given tweet ID, han
| max_results | Maximum number of results to return (max 100) |
| exclude | Types of tweets to exclude |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
|--------|-------------|
| ids | List of quote tweet IDs |
| texts | List of quote tweet text contents |
| next_token | Token for retrieving next page [more info](twitter/twitter.md#common-output). |
| next_token | Token for retrieving next page [more info](twitter.md#common-output). |
| data | Complete tweet data |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -219,12 +219,12 @@ It uses the Twitter API (Tweepy) to fetch retweeter information for a given twee
| tweet_id | ID of the tweet to get retweeters for |
| max_results | Maximum number of results per page (1-100) |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -234,8 +234,8 @@ It uses the Twitter API (Tweepy) to fetch retweeter information for a given twee
| usernames | List of usernames who retweeted |
| next_token | Token for retrieving next page |
| data | Complete user data |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -261,12 +261,12 @@ It queries the Twitter API (Tweepy) with the provided user ID to fetch tweets me
| user_id | ID of user to get mentions for |
| max_results | Number of results per page (5-100) |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -277,8 +277,8 @@ It queries the Twitter API (Tweepy) with the provided user ID to fetch tweets me
| userNames | List of usernames who mentioned target user |
| next_token | Token for retrieving next page |
| data | Complete tweet data |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -303,12 +303,12 @@ It uses the Twitter API (Tweepy) to fetch tweets from the home timeline, handlin
| credentials | Twitter API credentials with required scopes |
| max_results | Number of results per page (5-100) |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -319,8 +319,8 @@ It uses the Twitter API (Tweepy) to fetch tweets from the home timeline, handlin
| userNames | List of usernames who authored tweets |
| next_token | Token for retrieving next page |
| data | Complete tweet data |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -346,12 +346,12 @@ It uses the Twitter API (Tweepy) to fetch tweets from a specified user's timelin
| user_id | ID of user to get tweets from |
| max_results | Number of results per page (5-100) |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -362,8 +362,8 @@ It uses the Twitter API (Tweepy) to fetch tweets from a specified user's timelin
| userNames | List of usernames who authored tweets |
| next_token | Token for retrieving next page |
| data | Complete tweet data |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -387,12 +387,12 @@ It uses the Twitter API (Tweepy) to fetch a single tweet by its ID, handling aut
|-------|-------------|
| credentials | Twitter API credentials with required scopes |
| tweet_id | ID of the tweet to fetch |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -402,8 +402,8 @@ It uses the Twitter API (Tweepy) to fetch a single tweet by its ID, handling aut
| userId | ID of tweet author |
| userName | Username of tweet author |
| data | Complete tweet data |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Tweet metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Tweet metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -427,12 +427,12 @@ It uses the Twitter API (Tweepy) to batch fetch tweets by their IDs, handling au
|-------|-------------|
| credentials | Twitter API credentials with required scopes |
| tweet_ids | List of tweet IDs to fetch (max 100) |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -442,8 +442,8 @@ It uses the Twitter API (Tweepy) to batch fetch tweets by their IDs, handling au
| userIds | List of tweet author IDs |
| userNames | List of tweet author usernames |
| data | Complete tweet data array |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Tweet metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Tweet metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -497,9 +497,9 @@ It uses the Twitter API (Tweepy) to fetch information about users who liked a gi
| tweet_id | ID of tweet to get liking users for |
| max_results | Maximum number of results to return (1-100) |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -508,8 +508,8 @@ It uses the Twitter API (Tweepy) to fetch information about users who liked a gi
| username | List of usernames who liked |
| next_token | Token for retrieving next page |
| data | Complete user data |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -535,12 +535,12 @@ It uses the Twitter API (Tweepy) to fetch tweets liked by a given user ID, handl
| user_id | ID of user to get liked tweets for |
| max_results | Maximum number of results per page (5-100) |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -551,8 +551,8 @@ It uses the Twitter API (Tweepy) to fetch tweets liked by a given user ID, handl
| userNames | List of tweet author usernames |
| next_token | Token for retrieving next page |
| data | Complete tweet data |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -689,12 +689,12 @@ It uses the Twitter API (Tweepy) to fetch bookmarked tweets, handling pagination
| credentials | Twitter API credentials with required scopes |
| max_results | Maximum number of results per page (1-100) |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -705,8 +705,8 @@ It uses the Twitter API (Tweepy) to fetch bookmarked tweets, handling pagination
| userName | List of tweet author usernames |
| next_token | Token for retrieving next page |
| data | Complete tweet data |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -906,9 +906,9 @@ It uses the Twitter API (Tweepy) to fetch followers for a given user ID, handlin
| target_user_id | ID of user to get followers for |
| max_results | Maximum number of results per page (1-1000) |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -917,8 +917,8 @@ It uses the Twitter API (Tweepy) to fetch followers for a given user ID, handlin
| usernames | List of follower usernames |
| next_token | Token for retrieving next page |
| data | Complete user data |
| includes | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| includes | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -944,9 +944,9 @@ It uses the Twitter API (Tweepy) to fetch following list for a given user ID, ha
| target_user_id | ID of user to get following list for |
| max_results | Maximum number of results per page (1-1000) |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -955,8 +955,8 @@ It uses the Twitter API (Tweepy) to fetch following list for a given user ID, ha
| usernames | List of following usernames |
| next_token | Token for retrieving next page |
| data | Complete user data |
| includes | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| includes | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -1009,9 +1009,9 @@ It uses the Twitter API (Tweepy) to fetch muted users, handling authentication a
| credentials | Twitter API credentials with required scopes |
| max_results | Maximum results per page (1-1000, default 10) |
| pagination_token | Token for getting next/previous page |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1073,9 +1073,9 @@ It uses the Twitter API (Tweepy) to fetch user data for a single user identified
|-------|-------------|
| credentials | Twitter API credentials with required scopes |
| identifier | User identifier (either user ID or username) |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1108,9 +1108,9 @@ It uses the Twitter API (Tweepy) to batch fetch user data for multiple users ide
|-------|-------------|
| credentials | Twitter API credentials with required scopes |
| identifier | List of user identifiers (either user IDs or usernames, max 100) |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1145,9 +1145,9 @@ It uses the Twitter API (Tweepy) to search for Spaces matching the query paramet
| query | Search term to find in Space titles |
| max_results | Maximum number of results to return (1-100, default 10) |
| state | Type of Spaces to return (live, scheduled, or all) |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| space_fields | Space-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| space_fields | Space-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1182,9 +1182,9 @@ It uses the Twitter API (Tweepy) to batch fetch Space data for multiple Spaces,
|-------|-------------|
| credentials | Twitter API credentials with required scopes |
| identifier | Choice of lookup by Space IDs or creator user IDs |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| space_fields | Space-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| space_fields | Space-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1216,9 +1216,9 @@ It uses the Twitter API (Tweepy) to fetch Space data for a single Space ID, hand
|-------|-------------|
| credentials | Twitter API credentials with required scopes |
| space_id | ID of Space to retrieve |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| space_fields | Space-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| space_fields | Space-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1251,8 +1251,8 @@ It uses the Twitter API (Tweepy) to fetch buyer information for a Space, handlin
|-------|-------------|
| credentials | Twitter API credentials with required scopes |
| space_id | ID of Space to get buyers for |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1284,12 +1284,12 @@ It uses the Twitter API (Tweepy) to fetch tweets from a Space, handling authenti
|-------|-------------|
| credentials | Twitter API credentials with required scopes |
| space_id | ID of Space to get tweets for |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1322,9 +1322,9 @@ It uses the Twitter API (Tweepy) to fetch list data for a single list ID, handli
|-------|-------------|
| credentials | Twitter API credentials with required scopes |
| list_id | ID of the Twitter List to retrieve |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| list_fields | List-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| list_fields | List-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1361,9 +1361,9 @@ It uses the Twitter API (Tweepy) to fetch owned lists for a given user ID, handl
| user_id | ID of user whose Lists to retrieve |
| max_results | Maximum results per page (1-100, default 10) |
| pagination_token | Token for getting next page |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| list_fields | List-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| list_fields | List-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1532,12 +1532,12 @@ It uses the Twitter API (Tweepy) to fetch tweets from a specified List, handling
| list_id | ID of the List to get tweets from |
| max_results | Maximum number of results per page (1-100, default 10) |
| pagination_token | Token for getting next page of results |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter/twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter/twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter/twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| media_fields | Media-related fields to include [more info](twitter.md#common-input). |
| place_fields | Location-related fields to include [more info](twitter.md#common-input). |
| poll_fields | Poll-related fields to include [more info](twitter.md#common-input). |
| tweet_fields | Tweet-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1546,8 +1546,8 @@ It uses the Twitter API (Tweepy) to fetch tweets from a specified List, handling
| texts | List of tweet text contents |
| next_token | Token for retrieving next page |
| data | Complete tweet data array |
| included | Additional requested data [more info](twitter/twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter/twitter.md#common-output). |
| included | Additional requested data [more info](twitter.md#common-output). |
| meta | Pagination and result metadata [more info](twitter.md#common-output). |
| error | Error message if request failed |
### Possible use case
@@ -1715,9 +1715,9 @@ It uses the Twitter API (Tweepy) to fetch pinned Lists data, handling authentica
| Input | Description |
|-------|-------------|
| credentials | Twitter API credentials with required scopes |
| expansions | Additional data fields to include [more info](twitter/twitter.md#common-input). |
| list_fields | List-specific fields to include [more info](twitter/twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter/twitter.md#common-input). |
| expansions | Additional data fields to include [more info](twitter.md#common-input). |
| list_fields | List-specific fields to include [more info](twitter.md#common-input). |
| user_fields | User-related fields to include [more info](twitter.md#common-input). |
### Outputs
| Output | Description |
@@ -1905,3 +1905,62 @@ Information about Twitter users
- For user data in Tweets, add `expansions=Author_User_ID` and appropriate `user_fields`.
- Data returned under `includes` helps cross-reference expanded data objects with their parent entities using IDs.
## Common Output
The Twitter API returns standardized response elements across many endpoints. Here are the common output fields you'll encounter:
### data
The primary data requested in the response
| Field | Description |
|-------|-------------|
| ID | Unique identifier for the object |
| Type | Type of object (tweet, user, etc) |
| Properties | Object-specific fields like text for tweets |
### includes
Additional expanded data objects referenced in the primary data
| Field | Description |
|-------|-------------|
| Tweets | Full tweet objects that were referenced |
| Users | User profile data for authors/mentions |
| Places | Location data for geo-tagged content |
| Media | Details about attached photos/videos |
| Polls | Information about embedded polls |
### meta
Metadata about the response and pagination
| Field | Description |
|-------|-------------|
| Result_Count | Number of items returned |
| Next_Token | Token to get next page of results |
| Previous_Token | Token to get previous page |
| Newest_ID | Most recent ID in results |
| Oldest_ID | Oldest ID in results |
| Total_Tweet_Count | Total matching tweets (search) |
### errors
Details about any errors that occurred
| Field | Description |
|-------|-------------|
| Title | Brief error description |
| Detail | Detailed error message |
| Type | Error category/classification |
| Status | HTTP status code |
### Non-paginated responses
For single-object lookups:
- data: Contains requested object
- includes: Referenced objects
- errors: Any errors encountered
### Paginated responses
For multi-object lookups:
- data: Array of objects
- includes: Referenced objects
- meta: Pagination details
- errors: Any errors encountered