84 lines
6.5 KiB
Markdown
84 lines
6.5 KiB
Markdown
# Twitter
|
|
|
|
This page contains the setup guide and reference information for the Twitter source connector.
|
|
|
|
## Prerequisites
|
|
|
|
To set up the Twitter source connector, you'll need the [App only Bearer Token](https://developer.twitter.com/en/docs/authentication/oauth-2-0/bearer-tokens).
|
|
|
|
## Set up the Twitter connector in Airbyte
|
|
|
|
1. [Log into your Airbyte Cloud](https://cloud.airbyte.com/workspaces) account or navigate to the Airbyte Open Source dashboard.
|
|
2. Click **Sources** and then click **+ New source**.
|
|
3. On the Set up the source page, select **Twitter** from the Source type dropdown.
|
|
4. Enter the name for the Twitter connector.
|
|
5. For **Access Token**, enter the [App only Bearer Token](https://developer.twitter.com/en/docs/authentication/oauth-2-0/bearer-tokens).
|
|
6. For **Search Query**, enter the query for matching Tweets. You can learn how to build this query by reading [build a query guide](https://developer.twitter.com/en/docs/twitter-api/tweets/search/integrate/build-a-query).
|
|
7. For **Start Date (Optional)**, enter the date in `YYYY-MM-DDTHH:mm:ssZ` format. The start date for retrieving tweets cannot be more than 7 days in the past.
|
|
8. For **End Date (Optional)**, enter the date in `YYYY-MM-DDTHH:mm:ssZ` format. The end date for retrieving tweets must be a minimum of 10 seconds prior to the request time.
|
|
9. Click **Set up source**.
|
|
|
|
## Supported sync modes
|
|
|
|
The Twitter source connector supports the following [sync modes](https://docs.airbyte.com/cloud/core-concepts#connection-sync-modes):
|
|
|
|
- [Full Refresh - Overwrite](https://docs.airbyte.com/understanding-airbyte/connections/full-refresh-overwrite/)
|
|
- [Full Refresh - Append](https://docs.airbyte.com/understanding-airbyte/connections/full-refresh-append)
|
|
- [Incremental - Append](https://docs.airbyte.com/understanding-airbyte/connections/incremental-append)
|
|
|
|
## Supported Streams
|
|
|
|
- [Tweets](https://developer.twitter.com/en/docs/twitter-api/tweets/search/api-reference/get-tweets-search-recent)
|
|
- [Authors](https://developer.twitter.com/en/docs/twitter-api/tweets/search/api-reference/get-tweets-search-recent)
|
|
|
|
## Performance considerations
|
|
|
|
Rate limiting is mentioned in the API [documentation](https://developer.twitter.com/en/docs/twitter-api/rate-limits)
|
|
|
|
## Changelog
|
|
|
|
<details>
|
|
<summary>Expand to review</summary>
|
|
|
|
| Version | Date | Pull Request | Subject |
|
|
| :------ | :--------- | :------------------------------------------------------- | :------------------------------------------------ |
|
|
| 0.3.11 | 2025-05-10 | [60003](https://github.com/airbytehq/airbyte/pull/60003) | Update dependencies |
|
|
| 0.3.10 | 2025-05-04 | [59620](https://github.com/airbytehq/airbyte/pull/59620) | Update dependencies |
|
|
| 0.3.9 | 2025-04-27 | [58398](https://github.com/airbytehq/airbyte/pull/58398) | Update dependencies |
|
|
| 0.3.8 | 2025-04-12 | [57944](https://github.com/airbytehq/airbyte/pull/57944) | Update dependencies |
|
|
| 0.3.7 | 2025-04-05 | [57432](https://github.com/airbytehq/airbyte/pull/57432) | Update dependencies |
|
|
| 0.3.6 | 2025-03-29 | [56810](https://github.com/airbytehq/airbyte/pull/56810) | Update dependencies |
|
|
| 0.3.5 | 2025-03-22 | [56240](https://github.com/airbytehq/airbyte/pull/56240) | Update dependencies |
|
|
| 0.3.4 | 2025-03-08 | [55609](https://github.com/airbytehq/airbyte/pull/55609) | Update dependencies |
|
|
| 0.3.3 | 2025-03-01 | [55111](https://github.com/airbytehq/airbyte/pull/55111) | Update dependencies |
|
|
| 0.3.2 | 2025-02-22 | [54484](https://github.com/airbytehq/airbyte/pull/54484) | Update dependencies |
|
|
| 0.3.1 | 2025-02-15 | [54070](https://github.com/airbytehq/airbyte/pull/54070) | Update dependencies |
|
|
| 0.3.0 | 2024-12-10 | [48870](https://github.com/airbytehq/airbyte/pull/48870) | Add new stream `authors` |
|
|
| 0.2.8 | 2025-02-08 | [53515](https://github.com/airbytehq/airbyte/pull/53515) | Update dependencies |
|
|
| 0.2.7 | 2025-02-01 | [53037](https://github.com/airbytehq/airbyte/pull/53037) | Update dependencies |
|
|
| 0.2.6 | 2025-01-25 | [52432](https://github.com/airbytehq/airbyte/pull/52432) | Update dependencies |
|
|
| 0.2.5 | 2025-01-18 | [51975](https://github.com/airbytehq/airbyte/pull/51975) | Update dependencies |
|
|
| 0.2.4 | 2025-01-11 | [51426](https://github.com/airbytehq/airbyte/pull/51426) | Update dependencies |
|
|
| 0.2.3 | 2025-01-04 | [50378](https://github.com/airbytehq/airbyte/pull/50378) | Update dependencies |
|
|
| 0.2.2 | 2024-12-14 | [48192](https://github.com/airbytehq/airbyte/pull/48192) | Update dependencies |
|
|
| 0.2.1 | 2024-10-29 | [44710](https://github.com/airbytehq/airbyte/pull/44710) | Update dependencies |
|
|
| 0.2.0 | 2024-08-26 | [44777](https://github.com/airbytehq/airbyte/pull/44777) | Refactor connector to manifest-only format |
|
|
| 0.1.15 | 2024-08-17 | [44289](https://github.com/airbytehq/airbyte/pull/44289) | Update dependencies |
|
|
| 0.1.14 | 2024-08-12 | [43813](https://github.com/airbytehq/airbyte/pull/43813) | Update dependencies |
|
|
| 0.1.13 | 2024-08-10 | [43509](https://github.com/airbytehq/airbyte/pull/43509) | Update dependencies |
|
|
| 0.1.12 | 2024-08-03 | [43115](https://github.com/airbytehq/airbyte/pull/43115) | Update dependencies |
|
|
| 0.1.11 | 2024-07-27 | [42830](https://github.com/airbytehq/airbyte/pull/42830) | Update dependencies |
|
|
| 0.1.10 | 2024-07-20 | [42270](https://github.com/airbytehq/airbyte/pull/42270) | Update dependencies |
|
|
| 0.1.9 | 2024-07-13 | [41910](https://github.com/airbytehq/airbyte/pull/41910) | Update dependencies |
|
|
| 0.1.8 | 2024-07-10 | [41394](https://github.com/airbytehq/airbyte/pull/41394) | Update dependencies |
|
|
| 0.1.7 | 2024-07-06 | [40900](https://github.com/airbytehq/airbyte/pull/40900) | Update dependencies |
|
|
| 0.1.6 | 2024-06-25 | [40396](https://github.com/airbytehq/airbyte/pull/40396) | Update dependencies |
|
|
| 0.1.5 | 2024-06-22 | [40098](https://github.com/airbytehq/airbyte/pull/40098) | Update dependencies |
|
|
| 0.1.4 | 2024-06-06 | [39154](https://github.com/airbytehq/airbyte/pull/39154) | [autopull] Upgrade base image to v1.2.2 |
|
|
| 0.1.3 | 2024-05-21 | [38525](https://github.com/airbytehq/airbyte/pull/38525) | [autopull] base image + poetry + up_to_date |
|
|
| 0.1.2 | 2023-03-06 | [23749](https://github.com/airbytehq/airbyte/pull/23749) | Spec and docs are improved for beta certification |
|
|
| 0.1.1 | 2023-03-03 | [23661](https://github.com/airbytehq/airbyte/pull/23661) | Incremental added for the "tweets" stream |
|
|
| 0.1.0 | 2022-11-01 | [18883](https://github.com/airbytehq/airbyte/pull/18858) | 🎉 New Source: Twitter |
|
|
|
|
</details>
|