Overview

The Twitter API Suite offers multiple types of APIs, each designed for specific data collection needs from Twitter. Below is an overview of how these APIs connect and interact, based on the available features:

Profiles API

Profiles by URL

This API allows users to retrieve detailed Twitter profile information using the provided profile URL.

Input Parameters

URL
string
required

The Twitter profile URL.

max_number_of_posts
number

The number of posts to collect. If omitted, there is no limit.

Output Structure
Includes comprehensive data points:

  • Profile Details:
    x_id, url, id, profile_name, biography, is_verified, profile_image_link, external_link, date_joined, location, birth_date, posts_count, posts, suggested_profiles, is_business_account, is_government_account, category_name.

    For all data points, click here.

  • Engagement Metrics:
    followers, following, subscriptions.

  • Post Details:
    posts.

This API allows users to retrieve detailed Twitter profile information, including user engagement metrics, post details, and more, offering insights into user activity and profile data.

Posts API

Collect by URL

This API allows users to retrieve detailed post information from a specific Twitter post using the provided post URL.

Input Parameters

URL
string
required

The Twitter post URL.

API limitations: Up to 1000 posts per input.

Output Structure
Includes comprehensive data points:

  • Post Details:
    id, user_posted, name, description, date_posted, url, tagged_users, replies, reposts, likes, views, external_url, hashtags, quotes, bookmarks, external_image_urls, videos, quoted_post.

    For all data points, click here.

  • User Profile Details:
    followers, biography, posts_count, profile_image_link, following, is_verified.

  • Parent Post Details:
    parent_post_details.

This API allows users to retrieve detailed information about a specific Twitter post, including user details, engagement metrics, and media content, offering insights into post interactions and user activity.

Discover by Profile URL

This API allows users to discover and retrieve posts from a specific Twitter profile within a specified date range.

Input Parameters

URL
string
required

The URL of the Twitter profile.

start_date
string

Start date for filtering posts in MM-DD-YYYY format.

end_date
string

End date for filtering posts in MM-DD-YYYY format.

Output Structure
Includes comprehensive data points:

  • Post Details:
    id, user_posted, name, description, date_posted, url, tagged_users, replies, reposts, likes, views, external_url, hashtags, quotes, bookmarks, external_image_urls, videos, quoted_post.

    For all data points, click here.

  • User Profile Details:
    followers, biography, posts_count, profile_image_link, following, is_verified.

  • Parent Post Details:
    parent_post_details.

This API allows users to retrieve posts from a specific Twitter profile within a defined time frame, offering detailed insights into post interactions, user data, and media content.

Was this page helpful?