---
title: "Twitter Sentiment"
method: GET
path: "/sentiment/twitter"
tags: ["sentiment"]
---

# Twitter Sentiment

`GET /sentiment/twitter`

## Request

- Base URL: `https://mcp.f1ow.com/v1`
- URL: `https://mcp.f1ow.com/v1/sentiment/twitter`
- Auth: one of:
  - HTTP bearer
  - none

Searches public X Posts from the last 7 days using X search syntax (keywords, phrases, hashtags, cashtags, or operators such as from:handle). Returns engagement, views and direct links; sorted by relevance unless latest=true. Results are capped at 10 Posts.

## Query parameters

- `query` string, required: X recent-search query (keywords, phrases, hashtags, cashtags, or operators), e.g. "$BTC", "bitcoin ETF", or "from:handle BTC". Self-serve query limit: 512 characters.
- `latest` boolean: Return the newest Posts instead of top relevance. Defaults to false.
- `minLikes` integer: Only Posts with at least this many likes. Defaults to 0.
- `limit` integer: Max Posts to return (1-10). Defaults to 5.

## Response `200`

The result.

- object
  - `data` object
    - `tweets` object[]
      - `text` string
      - `createdAt` string: ISO 8601
      - `likes` number
      - `retweets` number
      - `replies` number
      - `views` number
      - `url` string: X Post permalink
  - `text` string, required: Human-readable rendering of the result.
  - `meta` ResponseMeta
    - `generatedAt` string, date-time: When the data was produced (source timestamp where the provider has one), ISO 8601 UTC

## Other responses

- `400`: An argument is missing or invalid.
- `401`: No credential was sent.
- `402`: x402 route: a priced call without a valid payment (challenge in the base64 PAYMENT-REQUIRED header). Metered routes: the account balance or access period is spent.
- `403`: The credential was rejected.
- `500`: Unexpected server error.
- `502`: The data source could not answer.

---

[API](https://skmtc.dev/f1ow/apis/f1ow-api.md) · [All operations](https://skmtc.dev/f1ow/apis/f1ow-api/llms.txt) · [OpenAPI document](https://skmtc.dev/f1ow/apis/f1ow-api/revisions/6974f25b6067?raw)