---
title: "Recent search counts"
method: GET
path: "/2/tweets/counts/recent"
tags: ["Tweets"]
---

# Recent search counts

`GET /2/tweets/counts/recent`

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

## Query parameters

- `query` string, required
- `start_time` string, date-time
- `end_time` string, date-time
- `since_id` string — Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
- `until_id` string — Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
- `next_token` string — A base36 pagination token.
- `pagination_token` string — A base36 pagination token.
- `granularity` 'minute' | 'hour' | 'day'
- `search_count.fields` string[] — The fields available for a SearchCount object.

## Response `200`

The request has succeeded.

- Get2TweetsCountsRecentResponse
  - `data` SearchCount[]
    - `end` string, date-time, required — The end time of the bucket.
    - `start` string, date-time, required — The start time of the bucket.
    - `tweet_count` integer, required — The count for the bucket.
  - `errors` Problem[]
    - `detail` string
    - `status` integer
    - `title` string, required
    - `type` string, required
  - `meta` object
    - `newest_id` string — The newest id in this response.
    - `next_token` string — The next token.
    - `oldest_id` string — The oldest id in this response.
    - `total_tweet_count` integer — The sum of results returned in this response.

## Other responses

- `default` — The request has failed.

---

[API](https://skmtc.net/mfullbrook/apis/current.md) · [All operations](https://skmtc.net/mfullbrook/apis/current/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mfullbrook/current/versions/4b066912ce32/schema)