Recent search counts

GET

/2/tweets/counts/recent

Tweets

Returns Tweet Counts from the last 7 days that match a search query.

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.twitter.com/2/tweets/counts/recent?query='

响应示例

200 - 示例 1

{
  "data": [
    {
      "end": "2019-08-24T14:15:22Z",
      "start": "2019-08-24T14:15:22Z",
      "tweet_count": 0
    }
  ],
  "errors": [
    {
      "detail": "string",
      "title": "string",
      "status": 0,
      "type": "about:blank"
    }
  ],
  "meta": {
    "next_token": "string",
    "total_tweet_count": 0
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

query

必需

One query/rule/filter for matching Tweets. Up to 2048 characters.

start_time

可选

YYYY-MM-DDTHH:mm:ssZ. The oldest UTC timestamp (from most recent 7 days) from which the Tweets will be provided. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute).

end_time

可选

YYYY-MM-DDTHH:mm:ssZ. The newest, most recent UTC timestamp to which the Tweets will be provided. Timestamp is in second granularity and is exclusive (i.e. 12:00:01 excludes the first second of the minute).

since_id

可选

Returns results with a Tweet ID greater than (that is, more recent than) the specified ID.

until_id

可选

Returns results with a Tweet ID less than (that is, older than) the specified ID.

next_token

可选

This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.

granularity

可选

The granularity for the search counts results.

返回响应

🟢200Recent tweet counts response

application/json

Body

data

array[object (SearchCount) {3}]

可选

>= 1 items

end

string <date-time>

必需

The end time of the bucket

start

string <date-time>

必需

The start time of the bucket

tweet_count

integer

必需

The count for the bucket

errors

array[null (Problem) {16}]

可选

>= 1 items

object

GenericProblem

可选

A generic problem with no additional information beyond that provided by the HTTP status code.

object

InvalidRequestProblem

可选

A problem that indicates this request is invalid.

object

ClientForbiddenProblem

可选

A problem that indicates your client is forbidden from making this request.

object

ResourceNotFoundProblem

可选

A problem that indicates that a given Tweet, User, etc. does not exist.

object

ResourceUnavailableProblem

可选

A problem that indicates a particular Tweet, User, etc. is not available to you.

object

ResourceUnauthorizedProblem

可选

A problem that indicates you are not allowed to see a particular Tweet, User, etc.

object

FieldUnauthorizedProblem

可选

A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.

object

DisallowedResourceProblem

可选

A problem that indicates that the resource requested violates the precepts of this API.

object

UnsupportedAuthenticationProblem

可选

A problem that indicates that the authentication used is not supported.

object

UsageCapExceededProblem

可选

A problem that indicates that a usage cap has been exceeded.

object

ConnectionExceptionProblem

可选

A problem that indicates something is wrong with the connection

object

ClientDisconnectedProblem

可选

Your client has gone away.

object

OperationalDisconnectProblem

可选

You have been disconnected for operational reasons.

object

RulesCapProblem

可选

You have exceeded the maximum number of rules.

object

InvalidRuleProblem

可选

The rule you have submitted is invalid.

object

DuplicateRuleProblem

可选

The rule you have submitted is a duplicate.