Skip to main content
GET
/
api
/
x
/
search
cURL
curl --request GET \
  --url https://api.recoupable.com/api/x/search \
  --header 'x-api-key: <api-key>'
{
  "status": "success",
  "tweets": [
    {
      "id": "<string>",
      "text": "<string>",
      "username": "<string>",
      "timestamp": 123,
      "createdAt": "<string>",
      "isReply": true,
      "isRetweet": true,
      "likes": 123,
      "retweetCount": 123,
      "replies": 123,
      "photos": [
        {
          "id": "<string>",
          "url": "<string>"
        }
      ],
      "videos": [
        {
          "id": "<string>",
          "preview": "<string>",
          "url": "<string>"
        }
      ],
      "urls": [
        "<string>"
      ],
      "permanentUrl": "<string>",
      "quotedStatusId": "<string>",
      "inReplyToStatusId": "<string>",
      "hashtags": [
        "<string>"
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Your Recoup API key. Learn more.

Query Parameters

​
query
string
required

The search query. Any Twitter-compatible query format can be used (e.g., '#nodejs', 'from:username', etc.)

​
maxTweets
integer
required

The maximum number of tweets to return

​
searchMode
enum<string>
default:Latest

The category filter to apply to the search

Available options:
Top,
Latest,
Photos,
Videos,
Users

Response

Tweets retrieved successfully

​
status
enum<string>

Status of the request

Available options:
success,
error
​
tweets
object[]

List of tweet objects