---
title: "X"
description: "Public posts with views, likes, replies and reposts, and keyword search. Account details come with each post."
url: https://docs.sonderlabs.co.uk/platforms/x
---

# X

Public posts with views, likes, replies and reposts, and keyword search. Account details come with each post.

## What you can get

| Data | Status | Notes |
| --- | --- | --- |
| Profiles | Limited | Followers come with each post; there is no standalone profile lookup. |
| Posts and stats | Live | Each public post with its caption, date, length, views, likes, comments and shares. |
| Keyword search | Live | Public posts that match a word or phrase, in a date window. |
| Hashtag search | Limited | Hashtags are searched as text. |
| Sound search | Not available |  |
| Comments | Limited | Replies are best effort and can be incomplete. |
| Transcripts | Not available |  |
| On-screen text | Limited | Read from the post's cover image only. |
| Media files | Not available |  |
| Audience (estimated) | Limited | Estimated from commenters' names and comment text only; no profile lookups. |
| Trends | Not available |  |
| Footage matching | Not available |  |

## Post fields

Every platform returns the same post shape ([all fields](https://docs.sonderlabs.co.uk/concepts#the-post)). On X:

- `comments` is the reply count and `shares` the repost count.
- Search takes X's own operators, such as `from:handle`.

Search kinds: `keyword`.

## Example post

A real public post found by Sonder's Red Bull Rampage 2026 demo campaign (illustration, not a client result). Numbers as of 2026-11-02.

A X post:

```json
{
  "id": "80dc91ee1795f1743f16cdc02625620c",
  "platform": "x",
  "externalId": "2109031637908595055",
  "url": "https://x.com/eMTBrides/status/2109031637908595055",
  "creator": {
    "handle": "eMTBrides",
    "name": "Larry Conger 🇺🇸",
    "followers": 173870
  },
  "caption": "What a run from @szymongodziek 💪🔥\n\nThe cancellation of Red Bull Rampage 2026 comes down to extreme wind and fairness. …",
  "hashtags": [
    "redbullrampage",
    "mtb",
    "bike",
    "freeride"
  ],
  "postedAt": "2026-10-10T21:21:41Z",
  "durationSec": 79,
  "views": 9143,
  "viewsEstimated": false,
  "likes": 80,
  "comments": 3,
  "shares": 51,
  "transcriptExcerpt": null,
  "onscreenText": "he stomped it 😤 | SZYMON | RedBull RAMPAGE",
  "asOf": "2026-11-02T23:04:08Z"
}
```

## Planned endpoints

> **Early access:** The REST API below is in early access: its endpoints are the planned shape and are not open for self-serve use yet. [Request access](https://docs.sonderlabs.co.uk/access). Live today: the [MCP server](https://docs.sonderlabs.co.uk/mcp) and the [free datasets](https://docs.sonderlabs.co.uk/datasets).

Planned shape:

```http
GET /v1/posts/search?platforms=x&q=red+bull+rampage&kind=keyword&since=2026-10-01 HTTP/1.1
Host: api.sonderlabs.co.uk
Authorization: Bearer <your API key>
```