---
title: "Track a tweet"
method: POST
path: "/api/crawl/tweet"
tags: ["Crawl Settings"]
---

# Track a tweet

`POST /api/crawl/tweet`

## Request

- Base URL: `https://api.xpoz.ai`
- URL: `https://api.xpoz.ai/api/crawl/tweet`
- Auth: HTTP bearer

Start collecting engagement on a tweet for a number of days. Requires the `trackTweets` flag.

## Request body

- object
  - `tweetId` string, required
  - `days` integer

## Response `201`

Created.

- DatasetBuildCreated
  - `id` string, required
  - `status` string, required

## Other responses

- `400`: Query or body validation failed. `message` joins all validation issues with `, `.
- `401`: Missing or invalid credentials.
- `403`: Caller lacks the required admin feature flag or `@xpoz.ai` email.
- `500`: Server error.

---

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