---
title: "Get Search Results"
method: GET
path: "/twitter/search"
tags: ["Data API"]
---

# Get Search Results

`GET /twitter/search`

Returns array of tweets provided by Twitter search. Typically Twitter returns ~20 results per page. You can request additional search results by sending another request to the same endpoint using cursor parameter. This endpoint supports all Twitter advanced search operators (to be passed within the 'query' value)

## Query parameters

- `query` string, required
- `cursor` string
- `type` 'Latest' | 'Top'

## Response `200`

Request succeeded

- TweetsResponse
  - `next_cursor` string, required — Cursor value used to obtain the subsequent page. To be passed to the same endpoint as 'cursor' query parameter. Value may contain spaces and other special characters and therefore must be url-encoded to avoid any errors
  - `tweets` Tweet[], required
    - `tweet_created_at` string, required — The UTC datetime when the tweet was created
    - `id_str` string, required — The string representation of the unique identifier for this Tweet. Implementations should use this rather than the large integer in id.
    - `text` string, nullable — Deprecated. Always `null`
    - `full_text` string, required — 100 tips I learned growing an iOS app to ~$5M in sales in 3 yrs, going through YC 1.5 times, and co-founding @Superwall 👇
    - `source` string, required — Utility used to post the Tweet, as an HTML-formatted string. Tweets from the Twitter website have a source value of web.
    - `truncated` boolean, required — Indicates whether the value of the text parameter was truncated, for example, as a result of a retweet exceeding the original Tweet text length limit of 140 characters. Since Twitter now rejects long Tweets vs truncating them, the large majority of Tweets will have this set to false.
    - `in_reply_to_status_id` integer, nullable — If the represented Tweet is a reply, this field will contain the integer representation of the original Tweet's ID.
    - `in_reply_to_status_id_str` string, nullable — If the represented Tweet is a reply, this field will contain the string representation of the original Tweet's ID.
    - `in_reply_to_user_id` integer, nullable — If the represented Tweet is a reply, this field will contain the integer representation of the original Tweet's author ID. This will not necessarily always be the user directly mentioned in the Tweet.
    - `in_reply_to_user_id_str` string, nullable — If the represented Tweet is a reply, this field will contain the string representation of the original Tweet's author ID. This will not necessarily always be the user directly mentioned in the Tweet.
    - `in_reply_to_screen_name` string, nullable — If the represented Tweet is a reply, this field will contain the screen name of the original Tweet's author.
    - `user` User, required — Twitter user account information
      - `id_str` string, required — The string representation of the unique identifier for this User. Implementations should use this rather than the large, possibly un-consumable integer in id.
      - `name` string, required — The name of the user, as they've defined it. Not necessarily a person's name. Typically capped at 50 characters, but subject to change.
      - `screen_name` string, required — The screen name, handle, or alias that this user identifies themselves with. screen_names are unique but subject to change. Use id_str as a user identifier whenever possible. Typically a maximum of 15 characters long, but some historical accounts may exist with longer names.
      - `location` string, required — The user-defined location for this account's profile. Not necessarily a location, nor machine-parseable. This field will occasionally be fuzzily interpreted by the Search service.
      - `url` string, nullable — A URL provided by the user in association with their profile.
      - `description` string, required — The user-defined UTF-8 string describing their account.
      - `protected` boolean, required — When true, indicates that this user has chosen to protect their Tweets.
      - `verified` boolean, required — When true, indicates that the user has a verified account with a blue checkmark.
      - `followers_count` integer, required — The number of followers this account currently has. Under certain conditions of duress, this field will temporarily indicate "0".
      - `friends_count` integer, required — The number of users this account is following (AKA their "followings"). Under certain conditions of duress, this field will temporarily indicate "0".
      - `listed_count` integer, required — The number of public lists that this user is a member of.
      - `favourites_count` integer, required — The number of Tweets this user has liked in the account's lifetime. British spelling used in the field name for historical reasons.
      - `statuses_count` integer, required — The number of Tweets (including retweets) issued by the user.
      - `created_at` string, required — The UTC datetime that the user account was created on Twitter.
      - `profile_banner_url` string, required — The HTTPS-based URL pointing to the standard web representation of the user's uploaded profile banner. By adding a final path element of the URL, it is possible to obtain different image sizes optimized for specific displays.
      - `profile_image_url_https` string, required — A HTTPS-based URL pointing to the user's profile image.
      - `can_dm` boolean, required — Indicates whether the authenticated user can send a direct message to this user.
    - `lang` string, required — Nullable. When present, indicates a BCP 47 language identifier corresponding to the machine-detected language of the Tweet text, or und if no language could be detected.
    - `quoted_status_id` integer, nullable — This field only surfaces when the Tweet is a quote Tweet. This field contains the integer value Tweet ID of the quoted Tweet.
    - `quoted_status_id_str` string, nullable — This field only surfaces when the Tweet is a quote Tweet. This is the string representation Tweet ID of the quoted Tweet.
    - `is_quote_status` boolean, required — Indicates whether this is a Quoted Tweet.
    - `is_pinned` boolean, required — Indicates if the tweet is pinned to the user's profile.
    - `quote_count` integer, required — Nullable. Indicates approximately how many times this Tweet has been quoted by Twitter users.
    - `reply_count` integer, required — Number of times this Tweet has been replied to.
    - `retweet_count` integer, required — Number of times this Tweet has been retweeted.
    - `favorite_count` integer, required — Nullable. Indicates approximately how many times this Tweet has been liked by Twitter users.
    - `views_count` integer, required — Number of views this tweet has received.
    - `bookmark_count` integer, required — Number of times this tweet has been bookmarked.
    - `quoted_status` Tweet — recursive
    - `retweeted_status` Tweet — recursive
    - `entities` TweetEntities, required
      - `urls` object[]
      - `user_mentions` object[]
      - `hashtags` object[]
      - `symbols` object[]
      - `media` object[]
      - `timestamps` object[]

## Other responses

- `402` — Payment required - not enough credits to perform this request. You should purchase additional credits
- `422` — Validation failed (e.g. one of the required parameters was not provided)
- `500` — API internal error, typically means that SocialData API failed to obtain the requested information. Retry may succeed

## Changes

- **2025-03-12** `73745ce76c49` — 1 breaking, 3 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/ErrorResponse, subschema #1` from the response body `oneOf` list for the response status `200`
  - added the required property `next_cursor` to the response with the `200` status
  - added the required property `tweets` to the response with the `200` status
- **2025-03-12** `b15e6bfa62d8` — 2 breaking, 3 warning
  - removed the required property `oneOf[subschema #1]/tweets/items/id` from the response with the `200` status
  - removed the required property `oneOf[subschema #1]/tweets/items/user/id` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1]/tweets/items/in_reply_to_status_id` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1]/tweets/items/in_reply_to_user_id` from the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/socialdata-api/apis/socialdata-api-reference/changes/twitter/search/get.md)

---

[API](https://skmtc.dev/socialdata-api/apis/socialdata-api-reference.md) · [All operations](https://skmtc.dev/socialdata-api/apis/socialdata-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/socialdata-api/socialdata-api-reference/revisions/73745ce76c49/schema)