Python SDK Reference

users = client.twitter.search_users("elon")
top_five = client.twitter.search_users("elon", limit=5)

followers = client.twitter.get_user_connections("elonmusk", "followers")
following = client.twitter.get_user_connections("elonmusk", "following")

users = client.twitter.get_users_by_keywords(
    '"machine learning"',
    fields=["username", "name", "followers_count", "relevant_tweets_count"],
    response_type=ResponseType.FAST,
    limit=20,
)

tweets = client.twitter.get_posts_by_ids(["1234567890", "0987654321"])

results = client.twitter.search_posts(
    '"artificial intelligence" AND ethics',
    start_date="2025-01-01",
    end_date="2025-06-01",
    language="en",
    fields=["id", "text", "like_count", "author_username", "created_at_date"],
)

retweets = client.twitter.get_retweets("1234567890")

quotes = client.twitter.get_quotes("1234567890")

comments = client.twitter.get_comments("1234567890")

commenters = client.twitter.get_post_interacting_users("1234567890", "commenters")

count = client.twitter.count_posts("bitcoin", start_date="2025-01-01")
print(f"{count:,} tweets mention bitcoin")

user = client.instagram.get_user("instagram")
print(f"{user.full_name} — {user.follower_count:,} followers")

users = client.instagram.search_users("nasa")
top_three = client.instagram.search_users("nasa", limit=3)

followers = client.instagram.get_user_connections("instagram", "followers")

users = client.instagram.get_users_by_keywords('"sustainable fashion"')

posts = client.instagram.get_posts_by_ids(["3606450040306139062_4836333238"])

results = client.instagram.get_posts_by_user("nasa")

results = client.instagram.search_posts("travel photography")

comments = client.instagram.get_comments("3606450040306139062_4836333238")

likers = client.instagram.get_post_interacting_users(
    "3606450040306139062_4836333238", "likers"
)

user = client.reddit.get_user("spez")
print(f"{user.username} — {user.total_karma:,} karma")

users = client.reddit.search_users("spez")
top_three = client.reddit.search_users("spez", limit=3)

users = client.reddit.get_users_by_keywords(
    '"machine learning"', subreddit="MachineLearning"
)

results = client.reddit.search_posts(
    "python tutorial",
    subreddit="learnpython",
    sort="top",
    time="month",
)

result = client.reddit.get_post_with_comments("abc123")
print(result.post.title)
for comment in result.comments:
    print(f"  {comment.author_username}: {comment.body[:80]}")

comments = client.reddit.search_comments("helpful tip", subreddit="LifeProTips")

subs = client.reddit.search_subreddits("machine learning")
top_five = client.reddit.search_subreddits("machine learning", limit=5)

result = client.reddit.get_subreddit_with_posts("wallstreetbets")
print(f"r/{result.subreddit.display_name} — {result.subreddit.subscribers_count:,} members")
for post in result.posts:
    print(f"  {post.title} ({post.score} points)")

subs = client.reddit.get_subreddits_by_keywords("cryptocurrency")

user = client.tiktok.get_user("charlidamelio")
print(f"{user.nickname} — {user.follower_count:,} followers")

# By numeric ID
user = client.tiktok.get_user("123456789", identifier_type="id")

users = client.tiktok.search_users("charli")
top_five = client.tiktok.search_users("charli", limit=5)

users = client.tiktok.get_users_by_keywords(
    '"machine learning"',
    response_type=ResponseType.FAST,
    limit=20,
)

posts = client.tiktok.get_posts_by_ids(["7123456789012345678"])

results = client.tiktok.get_posts_by_user("charlidamelio", start_date="2025-01-01")

results = client.tiktok.search_posts(
    "travel vlog",
    start_date="2025-01-01",
    response_type=ResponseType.FAST,
    limit=30,
)

results = client.tiktok.get_posts_by_hashtags(
    ["dance", "fyp"],
    response_type=ResponseType.FAST,
    limit=50,
)

users = client.tiktok.get_users_by_hashtags(
    ["sustainable_fashion"],
    response_type=ResponseType.FAST,
    limit=20,
)

comments = client.tiktok.get_comments("7123456789012345678")