直近の投稿数を取得する

検索クエリに一致する、直近 7 日間の投稿数を取得します。

GET /2/tweets/counts/recent

直近の投稿数を取得する

cURL

curl --request GET \
  --url https://api.x.com/2/tweets/counts/recent \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "end": "2023-11-07T05:31:56Z",
      "start": "2023-11-07T05:31:56Z",
      "tweet_count": 123
    }
  ],
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ],
  "meta": {
    "newest_id": "<string>",
    "next_token": "<string>",
    "oldest_id": "<string>",
    "total_tweet_count": 123
  }
}

承認

Authorization · string · header · 必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

クエリパラメータ

query · string · 必須

投稿と照合するための単一のクエリ／ルール／フィルターです。最大クエリ長については https://t.co/rulelength を参照してください。

Required string length: 1 - 4096

例:

"(from:TwitterDev OR from:TwitterAPI) has:media -is:retweet"

start_time · string<date-time>

YYYY-MM-DDTHH:mm:ssZ。過去7日間の範囲内で、ポストを取得する最も古いUTCタイムスタンプを指定します。タイムスタンプは秒単位の粒度で、両端を含みます（例：12:00:01 はその1分間の最初の1秒として含まれます）。

end_time · string<date-time>

YYYY-MM-DDTHH:mm:ssZ。ポストが返される、最も新しい（最新の）UTC タイムスタンプを指定します。タイムスタンプは秒単位の粒度で、排他的です（例: 12:00:01 を指定した場合、その分の最初の 1 秒は除外されます）。

since_id · string

指定した id より大きい（つまり、より新しい）ポストの id を持つ結果を返します。 このツイートの一意の識別子。大きな整数を扱えない言語やツールでの問題を避けるため、文字列として返されます。

Pattern: ^[0-9]{1,19}$

例:

"1346889436626259968"

until_id · string

指定した id より小さい（つまり、より古い）ポストの id を持つ結果を返します。 このツイートの一意の識別子。大きな整数を扱えない言語やツールでの問題を避けるため、文字列として返されます。

Pattern: ^[0-9]{1,19}$

例:

"1346889436626259968"

next_token · string

このパラメータは、結果の次ページを取得するために使用します。API レスポンスからそのまま返される値を指定し、変更しないでください。 Base36 形式のページネーショントークン。

Minimum string length: 1

pagination_token · string

このパラメータは、結果の次ページを取得するために使用します。API レスポンスからそのまま返される値を指定し、変更しないでください。 Base36 形式のページネーショントークン。

Minimum string length: 1

granularity · enum<string> · デフォルト: hour

検索結果件数の集計単位（粒度）を指定します。

利用可能なオプション: minute, hour, day

search_count.fields · enum<string>[]

レスポンスに含める SearchCount フィールドのカンマ区切りのリスト。 SearchCount オブジェクトで利用可能なフィールド。

Minimum array length: 1

利用可能なオプション: end, start, tweet_count

例:

["end", "start", "tweet_count"]

レスポンス

200

application/json

リクエストは成功しました。

data · object[]

Minimum array length: 1

Show child attributes

errors · object[]

Minimum array length: 1

IETF RFC 7807 (https://tools.ietf.org/html/rfc7807) で定義された HTTP Problem Details オブジェクト。

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Show child attributes

meta · object

Show child attributes