Add/Delete rules - Twitter API v2

Add or delete rules from a user's active rule set. Users can provide unique, optionally tagged rules to add. Users can delete their entire rule set or a subset specified by rule ids or values.

curl --location --request POST 'https://api.twitter.com/2/tweets/search/stream/rules' \ --header 'Content-Type: application/json' \ --data-raw '{ "add": [ { "tag": "Non-retweeted coffee tweets", "value": "coffee -is:retweet" } ] }'

{ "data": [ { "id": "120897978112909812", "tag": "Non-retweeted coffee tweets", "value": "coffee -is:retweet" } ], "meta": { "sent": "string", "summary": { "created": 1, "invalid": 1, "not_created": 1, "valid": 1 } } }

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

dry_run

可选

Dry Run can be used with both the add and delete action, with the expected result given, but without actually taking any action in the system (meaning the end state will always be as it was when the request was submitted). This is particularly useful to validate rule changes.

Body 参数application/json

AddOrDeleteRulesRequest

可选

One of

AddRulesRequest

DeleteRulesRequest

A request to add a user-specified stream filtering rule.

add

array[object (RuleNoId) {2}]

必需

示例

返回响应

🟢200The request was successful

application/json

Body

AddOrDeleteRulesResponse

可选

One of

AddRulesResponse

DeleteRulesResponse

A response from adding user-specified stream filtering rules.

data

array[object (Rule) {3}]

必需

All user-specified stream filtering rules that were created.