Plugin: Twitter V2 API gatherer
Purpose
Use this plugin to index content from a paid Twitter service using the V2 API.
By default, the most recent ten Tweets are returned per request.
When to use this plugin
Use this plugin if you have paid for a Twitter accound and would like to include Tweets as part of your search results.
| This plugin requires a paid Twitter account. You need at least Paid Basic API access to pull tweets Twitter API access levels and versions |
Usage
Enable the plugin
-
Select Plugins from the side navigation pane and click on the Twitter V2 API gatherer tile.
-
From the Location section, select the data source to which you would like to enable this plugin from the Select a data source select list.
| The plugin will take effect after setup steps and an advanced > full update of the data source has completed. |
Configuration settings
The configuration settings section is where you do most of the configuration for your plugin. The settings enable you to control how the plugin behaves.
| The configuration key names below are only used if you are configuring this plugin manually. The configuration keys are set in the data source configuration to configure the plugin. When setting the keys manually you need to type in (or copy and paste) the key name and value. |
User access token
Configuration key |
|
Data type |
Encrypted string |
Required |
This setting is required |
Your Twitter API access token. See: https://developer.twitter.com/en/docs/authentication/oauth-2-0/bearer-tokens for more information.
Twitter user Id
Configuration key |
|
Data type |
string |
Required |
This setting is optional |
Your Twitter userId (if known).
Twitter user name
Configuration key |
|
Data type |
string |
Required |
This setting is required |
Your Twitter user name. The can be obtained from your profile and is the value after the @ symbol. It will be used to retrieve userId.
Additional Twitter query parameters
Configuration key |
|
Data type |
string |
Required |
This setting is required |
Specify additional parameters for the Twitter query. This can be used to modify the fields returned, or apply scoping to your Twitter query. The Parameter 1 field should be used to specify the Twitter query parameter name. More info: https://developer.twitter.com/en/docs/twitter-api/tweets/timelines/api-reference/get-users-id-tweets
You need to provide either a userName or userId (or both).
|
Notes
If you want to have Tweet URLs created with userName: https://twitter.com/<userName>/status/<tweetId>, you need to provide it as a config key (see above).
If you don’t provide a userName the URLs will be created with userId: https://twitter.com/<userId>/status/<tweetId>;
By default, the plugin will request only tweetId and tweetText fields form API.
...
{
"edit_history_tweet_ids": [
"123456123456"
],
"id": "123456123456",
"text": "Congratulations to Professor John Doe on receiving...."
},
...Additional fields can be requested by setting the additional Twitter query parameters option (see above).
Filter chain configuration
This plugin uses filters which are used to apply transformations to the gathered content.
The filters run in sequence and need be set in an order that makes sense. The plugin supplied filter(s) (as indicated in the listing) should be re-ordered to an appropriate point in the sequence.
| Changes to the filter order affects the way the data source processes gathered documents. See: document filters documentation. |
Examples
Example: Specify additional Twitter fields to include in the response
Get the created_at field added to the set of fields returned by the Twitter API.
| Configuration key name | Parameter 1 | Value |
|---|---|---|
Additional Twitter query parameters |
|
|
Get the created_at and author_id fields added to the set of fields returned by the Twitter API.
| Configuration key name | Parameter 1 | Value |
|---|---|---|
Additional Twitter query parameters |
|
|