Advanced Search & Query Operations

Leverage powerful search capabilities to find exactly the tweets you need. Our advanced search system combines semantic similarity, keyword matching, and sophisticated filtering to deliver highly relevant results from Twitter/X.

Semantic Search

Find tweets based on meaning and context using vector embeddings

Hybrid Search

Combine semantic similarity with keyword matching for precise results

Smart Filtering

Apply complex filters including date ranges, engagement metrics, and user targeting

Query Operators

Use Twitter’s native query syntax for advanced tweet discovery

Advanced Search provides powerful filtering capabilities to help you find exactly the tweets you need. Using complex query operators, you can filter by date ranges, users, hashtags, engagement metrics, and more. These operators can be combined to create highly targeted searches. This guide covers all available search operators with syntax examples and sample API calls to help you construct effective queries.

Search Operations

Query-Based Search

Search tweets using the searchbyquery endpoint with Twitter’s native query syntax. Supports advanced operators, filters, and targeting options for precise tweet discovery.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "searchbyquery",
    "query": "climate change",
    "max_results": 10
  }
}

Full Archive Search

Access Twitter’s complete historical tweet archive using the searchbyfullarchive endpoint.

{
  "type": "twitter-api",
  "arguments": {
    "type": "searchbyfullarchive",
    "query": "NASA",
    "max_results": 100
  }
}

Get Tweet by ID

Retrieve a specific tweet using its unique Twitter ID by using the getbyid endpoint. Perfect for fetching individual tweets when you have the exact tweet identifier.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "getbyid",
    "query": "1881258110712492142"
  }
}

Get Replies to a Tweet

Retrieve all replies to a specific tweet using its unique Twitter ID by using the getreplies endpoint. This endpoint returns threaded conversations and responses, allowing you to analyze engagement and discussion around particular content.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "getreplies",
    "query": "1234567890",
    "max_results": 20
  }
}

Get Retweeters

Retrieve all users who retweeted a specific tweet using its unique Twitter ID by using the getretweeters endpoint. This endpoint returns a list of users who have retweeted the tweet, allowing you to analyze engagement and discussion around particular content.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "getretweeters",
    "query": "1234567890",
    "max_results": 50
  }
}

User Timeline Operations

Get Tweets from a User’s Timeline

Retrieve tweets from a user’s timeline using their unique Twitter ID by using the gettweets endpoint. This endpoint returns a list of tweets from the user’s timeline, allowing you to analyze their activity and content.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "gettweets",
    "query": "NASA",
    "max_results": 50
  }
}

Get Media (Photos/Videos) from a User

Retrieve media (photos/videos) from a user’s timeline using their unique Twitter ID by using the getmedia endpoint. This endpoint returns a list of media from the user’s timeline, allowing you to analyze their activity and content.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "getmedia",
    "query": "NASA",
    "max_results": 20
  }
}

Profile Operations

Get User Profile Information

Retrieve user profile information using their unique Twitter ID by using the searchbyprofile endpoint. This endpoint returns a list of user profile information, allowing you to analyze their activity and content.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "searchbyprofile",
    "query": "NASA_Marshall"
  }
}

Get User Profile by User ID

Retrieve user profile information using their unique Twitter ID by using the getprofilebyid endpoint. This endpoint returns a list of user profile information, allowing you to analyze their activity and content.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "getprofilebyid",
    "query": "44196397"
  }
}

Get Followers of a Profile

Retrieve followers of a profile using their unique Twitter ID by using the getfollowers endpoint. This endpoint returns a list of followers of the profile, allowing you to analyze their activity and content.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "getfollowers",
    "query": "NASA",
    "max_results": 100
  }
}

Get Users that a Profile is Following

Retrieve users that a profile is following using their unique Twitter ID by using the getfollowing endpoint. This endpoint returns a list of users that the profile is following, allowing you to analyze their activity and content.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "getfollowing",
    "query": "NASA",
    "max_results": 100
  }
}

Other Operations

Retrieve trending topics by using the gettrends endpoint. This endpoint returns a list of trending topics, allowing you to analyze the current trends and topics.

{
  "type": "twitter-credential",
  "arguments": {
    "type": "gettrends"
  } 
}

Data API