---
title: "Search Twitter for tweets"
method: POST
path: "/twitter/search-tweets"
tags: ["Twitter"]
---

# Search Twitter for tweets

`POST /twitter/search-tweets`

Search tweets on Twitter for a given query

## Request body

- object
  - `query` string, required — The search query string
  - `type` 'top' | 'photos' | 'videos' | 'latest' — The type of search
  - `count` integer — The number of results to retrieve

## Response `200`

SearchTweets API successful response

- object
  - `tweets` Tweet[]
    - `tweet_id` string — Unique identifier for the tweet
    - `full_text` string — The full text of the tweet
    - `created_at` string — The timestamp when the tweet was created
    - `author_user_id` string — The ID of the user who authored the tweet
    - `bookmark_count` integer — Number of times the tweet has been bookmarked
    - `reply_count` integer — Number of replies to the tweet
    - `retweet_count` integer — Number of times the tweet has been retweeted
    - `retweeted` boolean — Indicates if the tweet is a retweet
    - `urls` string[] — List of URLs included in the tweet

## Other responses

- `400` — User error response
- `500` — Server error response

---

[API](https://skmtc.net/carvedai/apis/exfunc-apis.md) · [All operations](https://skmtc.net/carvedai/apis/exfunc-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carvedai/exfunc-apis/revisions/22587fdf9a5e/schema)