메인 콘텐츠로 건너뛰기
GET
/
2
/
tweets
/
counts
/
all
모든 포스트 수 가져오기
curl --request GET \
  --url https://api.x.com/2/tweets/counts/all \
  --header 'Authorization: Bearer <token>'
{
  "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 형식. 포스트가 반환될 수 있는 가장 이른 UTC 타임스탬프입니다. 타임스탬프는 초 단위까지의 정밀도를 가지며, 이 값은 포함됩니다(예: 12:00:01은 해당 분의 첫 번째 초를 포함합니다).

​
end_time
string<date-time>

YYYY-MM-DDTHH:mm:ssZ 형식. 포스트가 반환될 수 있는 가장 나중의 UTC 타임스탬프입니다. 타임스탬프는 초 단위까지의 정밀도를 가지며, 이 값은 제외됩니다(예: 12:00:01은 해당 분의 첫 번째 초를 포함하지 않습니다).

​
since_id
string

지정한 ID보다 큰(즉, 더 최근에 작성된) 게시물 ID를 가진 결과를 반환합니다. 이 Tweet의 고유 식별자입니다. 일부 언어 및 도구에서 큰 정수를 처리하지 못해 발생하는 문제를 피하기 위해 문자열로 반환됩니다.

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

"1346889436626259968"

​
until_id
string

지정한 ID보다 작은(즉, 더 이전에 작성된) 게시물 ID를 가진 결과를 반환합니다. 이 Tweet의 고유 식별자입니다. 일부 언어 및 도구에서 큰 정수를 처리하지 못해 발생하는 문제를 피하기 위해 문자열로 반환됩니다.

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

검색 개수 결과에 사용할 세분성(granularity)을 지정합니다.

사용 가능한 옵션:
minute,
hour,
day
​
search_count.fields
enum<string>[]

표시할 SearchCount 필드를 쉼표로 구분한 목록입니다. SearchCount 객체에서 사용할 수 있는 필드입니다.

Minimum array length: 1
사용 가능한 옵션:
end,
start,
tweet_count
예시:
["end", "start", "tweet_count"]

응답

요청이 성공했습니다.

​
data
object[]
Minimum array length: 1
​
errors
object[]
Minimum array length: 1

IETF RFC 7807(https://tools.ietf.org/html/rfc7807)에 정의된 HTTP Problem Details 객체

​
meta
object