Name: X Twitter Data API: Profiles & Tweets Without Official Keys
Brand: xdata
SKU: api-xdata-x-twitter-data
Availability: InStock
Author: API Market

我在

# X Twitter Data

## Overview
The X Twitter Data API provides real-time access to public data on X (formerly Twitter) without requiring official X API keys, OAuth, or an approval process. Developers can easily look up any public X profile and fetch a user's recent tweets and replies by their handle. All data is returned as clean, structured JSON, ready to be integrated into applications. This API simplifies the process of gathering X data, making it accessible and efficient for various use cases.

## Features
*   **No Official X Credentials Needed:** Access public X data without dealing with X API keys, OAuth, or lengthy approval processes.
*   **Structured JSON Responses:** Receive clean, well-organized JSON data that drops straight into your application logic.
*   **Fast Response Times:** Experience quick data retrieval, with typical response times under one second.
*   **Simple Handle-Based Lookups:** Easily find profiles and tweets using X handles (e.g., `elonmusk`) instead of complex numeric IDs.
*   **Comprehensive Profile Data:** Fetch essential public profile information including follower/following counts, total tweet count, bio, verified status, account creation date, and avatar URL.
*   **Recent Tweets & Replies:** Retrieve a user's latest tweets and replies, complete with text, timestamps, media URLs, tweet IDs, and reply references.

## Use Cases
*   **Social Media Monitoring for Brands:** Companies can track brand mentions, monitor public sentiment around their products or services, and analyze competitive activity on X in real-time.
*   **Influencer Marketing & Lead Generation:** Businesses can identify key influencers or potential leads by analyzing public profiles and recent activity to inform outreach strategies.
*   **Sentiment Analysis and Trend Spotting:** Data analysts can perform sentiment analysis on user activity, track emerging trends, and gain insights into public opinion on specific topics.
*   **News & Content Aggregation:** Media organizations or content platforms can integrate X data to curate relevant news feeds, monitor breaking stories, or power social dashboards.
*   **Bot Development & Automated Alerts:** Developers can build bots that respond to specific X events or create automated alert systems based on predefined public X data triggers.

## API Documentation

### Base URL
All API requests should be made to: `https://prod.api.market/api/v1/xdata/x-twitter-data`

### Authentication
Authentication is handled via API key. Include your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### Get User Profile
Returns a public X profile by handle, including follower count, following count, total tweet count, bio, verified status, account creation date, and avatar URL. Pass the handle without the `@` symbol (e.g. `elonmusk`).

**Path:** `/v1/user`
**Method:** `GET`
**Description:** Returns a public X profile by handle: followers, following, tweets, bio, verified, created_at and profile image.

**Parameters:**

| Name        | Type    | In     | Required | Description                                    | Example    |
| :---------- | :------ | :----- | :------- | :--------------------------------------------- | :--------- |
| `screen_name` | `string` | `query` | Yes      | X handle without the `@` symbol (e.g. `elonmusk`). | `elonmusk` |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/xdata/x-twitter-data/v1/user?screen_name=elonmusk" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**

```json
{
  "handle": "elonmusk",
  "name": "Elon Musk",
  "bio": "Technology visionary. CEO of Tesla & SpaceX. Founder of X and The Boring Company.",
  "followers_count": 180123456,
  "following_count": 315,
  "tweets_count": 35432,
  "verified": true,
  "created_at": "2009-06-02T16:12:08Z",
  "avatar_url": "https://pbs.twimg.com/profile_images/1683325380447959040/qpmH3y0F_400x400.jpg",
  "profile_url": "https://twitter.com/elonmusk"
}
```

#### Get User Tweets
Returns a user's recent tweets and replies by handle, including tweet text, timestamp, media URLs, tweet ID, and reply references.

**Path:** `/v1/user/tweets`
**Method:** `GET`
**Description:** Returns a user's recent tweets and replies by handle: text, timestamp, media URLs and reply references.

**Parameters:**

| Name        | Type     | In     | Required | Description                                    | Example    | Default |
| :---------- | :------- | :----- | :------- | :--------------------------------------------- | :--------- | :------ |
| `screen_name` | `string` | `query` | Yes      | X handle without the `@` symbol.               | `nasa`     |         |
| `count`     | `integer` | `query` | No       | Number of items to return, 1-100.              | `50`       | `20`    |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/xdata/x-twitter-data/v1/user/tweets?screen_name=nasa&count=3" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**

```json
[
  {
    "id": "1720000000000000001",
    "text": "Our Perseverance rover spotted this unique rock formation on Mars! What do you think it looks like? #Mars2020",
    "created_at": "2023-10-30T14:15:00Z",
    "media_urls": ["https://example.com/mars_rock_image.jpg"],
    "reply_to_tweet_id": null,
    "reply_to_user_handle": null,
    "tweet_url": "https://twitter.com/nasa/status/1720000000000000001"
  },
  {
    "id": "1719000000000000002",
    "text": "Happy Halloween from the International Space Station! Our astronauts are celebrating in orbit. 🎃 #ISS",
    "created_at": "2023-10-31T09:00:00Z",
    "media_urls": [],
    "reply_to_tweet_id": null,
    "reply_to_user_handle": null,
    "tweet_url": "https://twitter.com/nasa/status/1719000000000000002"
  },
  {
    "id": "1718000000000000003",
    "text": "@Space_Explorers We're constantly working on new ways to explore the cosmos. Stay tuned for exciting updates!",
    "created_at": "2023-10-29T11:45:00Z",
    "media_urls": [],
    "reply_to_tweet_id": "1717000000000000000",
    "reply_to_user_handle": "Space_Explorers",
    "tweet_url": "https://twitter.com/nasa/status/1718000000000000003"
  }
]
```

## Status Codes
This API uses standard HTTP status codes to indicate the success or failure of an API request.

*   **200 OK:** Request successful. The response body contains the requested data.
*   **201 Created:** Resource successfully created. (Less common for this read-only API but included for completeness).
*   **400 Bad Request:** Invalid input parameters or a malformed request. Check your query parameters (`screen_name`, `count`) and ensure they meet the specified requirements.
*   **401 Unauthorized:** Missing or invalid API key. Ensure you are sending the `x-api-market-key` header with a valid API key.
*   **403 Forbidden:** Valid API key but insufficient permissions. This might occur if your API key does not have access to this specific service.
*   **404 Not Found:** Resource not found. This could happen if the requested user handle does not exist or the endpoint path is incorrect.
*   **429 Too Many Requests:** Rate limit exceeded. You have sent too many requests in a given time frame. Implement exponential backoff for retries.
*   **500 Internal Server Error:** A server-side error occurred. This indicates an unexpected issue on the API's end. It's usually transient; retrying after a short delay might resolve it.
*   **503 Service Unavailable:** The service is temporarily unavailable, often due to maintenance or heavy load. Implement retries with exponential backoff.



## FAQ
**Q: Do I need an official X (Twitter) API key to use this service?**

A: No, this API does not require any official X API keys, OAuth, or approval processes. You only need your API.market key.

**Q: Is this API real-time?**

A: Yes, the API provides real-time access to public data available on X.

**Q: What information can I get about a user profile?**

A: You can retrieve a user's handle, name, bio, follower count, following count, total tweet count, verified status, account creation date, avatar URL, and profile URL.

**Q: Can I fetch private tweets or direct messages?**

A: No, the API only provides access to public information available on X. It cannot access private tweets, direct messages, or any other non-public data.

**Q: What is the maximum number of tweets I can retrieve at once?**

A: You can retrieve up to 100 recent tweets or replies per request using the `count` parameter. The default is 20.

**Q: How are API units counted?**

A: 1 API unit equals 1 image processed. (Note: For this API, a more accurate statement would be 1 API unit per successful API request, but we are using the provided pricing text verbatim.)

**Q: What happens if I hit a rate limit?**

A: If you exceed the rate limits, you will receive a `429 Too Many Requests` error. It's recommended to implement a retry mechanism with exponential backoff.

**Q: How quickly can I get started?**

A: You can get started in minutes. Once you have an API.market key, you can immediately begin making requests.

## Contact Us
If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.

Access real-time public X (Twitter) profiles and tweets by handle without official API keys. Get structured JSON for social monitoring, influencer research, and

X Twitter Data API: Profiles & Tweets Without Official Keys

FREE

XData

Look up public X (Twitter) profiles and fetch recent tweets by handle in real-time with fast sub-second responses, all without needing official X API keys.