# X (Twitter) Tweet Search

<p>Search public tweets by keyword.</p>

- **Documentation:** [https://scrappa.co/docs/x-twitter/x_twitter_search_tweets](https://scrappa.co/docs/x-twitter/x_twitter_search_tweets)
- **API group:** X (Twitter) API
- **Endpoint:** `GET https://scrappa.co/api/x-twitter/search/tweets`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | <p>Search query.</p> |
| `cursor` | string | No | <p>Opaque cursor from the previous page. Pagination is driven by this value; the returned result count is the authoritative page size.</p> |
| `count` | integer | No | <p>Requested page size. Advisory only: the upstream sets the page size, so the returned result count is what matters.</p> |
| `lang` | string | No | <p>Result language code.</p> |

## Example response

```json
{
    "count": 1,
    "cursor": "DAABCgACF__sample_opaque_cursor",
    "results": [
        {
            "id": "1234567890123456789",
            "text": "Public tweet text.",
            "views": 180000,
            "author": {
                "name": "Example Account",
                "screen_name": "example"
            },
            "quotes": 31,
            "replies": 88,
            "retweets": 512,
            "bookmarks": 120,
            "created_at": "Tue Mar 05 09:20:00 +0000 2026"
        }
    ]
}
```

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)