Skip to content

Commit 915b5fb

Browse files
lanbytescursoragent
andcommitted
Add a Haystack components page to the Mintlify docs.
Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent d14893b commit 915b5fb

9 files changed

Lines changed: 34 additions & 10 deletions

File tree

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
66
Documentation for [TwexAPI](https://twexapi.io), an X (Twitter) Scraper API and X API alternative. Intended for **[docs.twexapi.io](https://docs.twexapi.io)**.
77

8-
This repository covers REST, MCP, SDKs, CLI, Terraform, n8n, Prefect, and Apify. The OpenAPI contract currently documents **66** operations.
8+
This repository covers REST, MCP, SDKs, CLI, Terraform, n8n, Prefect, Haystack, and Apify. The OpenAPI contract currently documents **66** operations.
99

1010
## Start here
1111

@@ -34,6 +34,7 @@ python3 scripts/generate-api-pages.py
3434
- [TypeScript SDK](https://github.com/twexapi-dev/x-api-scraper-typescript)
3535
- [n8n node](https://github.com/twexapi-dev/n8n-nodes-x-api-scraper)
3636
- [Prefect collection](https://github.com/twexapi-dev/prefect-x-api-scraper)
37+
- [Haystack components](https://github.com/twexapi-dev/x-api-scraper-haystack)
3738

3839
## License
3940

changelog.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,5 +6,5 @@ description: "Docs repository changes for the TwexAPI Mintlify site."
66
## 2026-08-24
77

88
- First public docs repository aligned with the 66-operation SDK OpenAPI.
9-
- REST, MCP, SDK, CLI, Terraform, n8n, Prefect, and Apify coverage.
9+
- REST, MCP, SDK, CLI, Terraform, n8n, Prefect, Haystack, and Apify coverage.
1010
- No webhook, monitor, or OAuth CIMD pages. Those APIs are not in the current OpenAPI.

context7.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"projectTitle": "TwexAPI docs",
3-
"description": "TwexAPI documentation for REST API, MCP, SDKs, CLI, Terraform, n8n, Prefect, and X/Twitter public reads plus approved writes. Not affiliated with X Corp.",
3+
"description": "TwexAPI documentation for REST API, MCP, SDKs, CLI, Terraform, n8n, Prefect, Haystack, and X/Twitter public reads plus approved writes. Not affiliated with X Corp.",
44
"branch": "main",
55
"rules": [
66
"Not affiliated with X Corp.",

docs.json

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"$schema": "https://mintlify.com/docs.json",
33
"theme": "maple",
44
"name": "TwexAPI",
5-
"description": "TwexAPI docs for tweet search, follower scraping, timelines, DMs, SDKs, MCP, CLI, Terraform, n8n, and Prefect. Not affiliated with X Corp.",
5+
"description": "TwexAPI docs for tweet search, follower scraping, timelines, DMs, SDKs, MCP, CLI, Terraform, n8n, Prefect, and Haystack. Not affiliated with X Corp.",
66
"search": {
77
"prompt": "Search docs"
88
},
@@ -89,7 +89,8 @@
8989
"sdks/cli",
9090
"sdks/terraform",
9191
"sdks/n8n",
92-
"sdks/prefect"
92+
"sdks/prefect",
93+
"sdks/haystack"
9394
]
9495
},
9596
{

index.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "TwexAPI X (Twitter) Scraper API"
33
sidebarTitle: Home
4-
description: "Search tweets, read profiles, paginate followers, and run approved X actions through TwexAPI REST, SDKs, MCP, CLI, Terraform, n8n, Prefect, or Apify. Not affiliated with X Corp."
4+
description: "Search tweets, read profiles, paginate followers, and run approved X actions through TwexAPI REST, SDKs, MCP, CLI, Terraform, n8n, Prefect, Haystack, or Apify. Not affiliated with X Corp."
55
---
66

77
TwexAPI is an X (Twitter) Scraper API and X API alternative. Search tweets, read profiles, paginate followers, and run approved account actions.
@@ -38,7 +38,7 @@ Pass `next_cursor` from the previous page unchanged to fetch the next page.
3838
Hosted MCP at `https://api.twexapi.io/mcp` with `explore` and `twexapi_request`.
3939
</Card>
4040
<Card title="SDKs" icon="package" href="/sdks">
41-
TypeScript, Python, Go, Java, Kotlin, C#, Ruby, PHP, CLI, Terraform, n8n, and Prefect.
41+
TypeScript, Python, Go, Java, Kotlin, C#, Ruby, PHP, CLI, Terraform, n8n, Prefect, and Haystack.
4242
</Card>
4343
</CardGroup>
4444

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "x-api-scraper-docs",
33
"private": true,
4-
"description": "TwexAPI documentation source for REST, MCP, SDKs, CLI, Terraform, n8n, and Prefect. Not affiliated with X Corp.",
4+
"description": "TwexAPI documentation source for REST, MCP, SDKs, CLI, Terraform, n8n, Prefect, and Haystack. Not affiliated with X Corp.",
55
"scripts": {
66
"dev": "npx mintlify@latest dev",
77
"generate:api": "python3 scripts/generate-api-pages.py"

sdks.mdx

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "TwexAPI SDKs and clients"
33
sidebarTitle: SDKs
4-
description: "Install TwexAPI TypeScript, Python, Go, Java, Kotlin, C#, Ruby, PHP, CLI, Terraform, n8n, and Prefect clients. Not affiliated with X Corp."
4+
description: "Install TwexAPI TypeScript, Python, Go, Java, Kotlin, C#, Ruby, PHP, CLI, Terraform, n8n, Prefect, and Haystack clients. Not affiliated with X Corp."
55
---
66

77
Official clients wrap the same REST contract. Public reads use `X_API_SCRAPER_KEY`. Writes still need a cookie or `auth_token`.
@@ -43,6 +43,9 @@ Official clients wrap the same REST contract. Public reads use `X_API_SCRAPER_KE
4343
<Card title="Prefect" href="/sdks/prefect" icon="calendar">
4444
Collection `prefect-x-api-scraper`
4545
</Card>
46+
<Card title="Haystack" href="/sdks/haystack" icon="layers">
47+
Components `x-api-scraper-haystack`
48+
</Card>
4649
<Card title="Apify" href="/guides/apify" icon="database">
4750
Pay-per-result tweet Actor, no TwexAPI key
4851
</Card>

sdks/haystack.mdx

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: "Haystack components"
3+
description: "Install x-api-scraper-haystack for tweet search and user timelines in Haystack RAG pipelines."
4+
---
5+
6+
Install `x-api-scraper-haystack`. Components read `X_API_SCRAPER_KEY` and send `Authorization: Bearer`.
7+
8+
```bash
9+
pip install x-api-scraper-haystack
10+
```
11+
12+
| Task | Haystack component | TwexAPI route |
13+
| --- | --- | --- |
14+
| Search tweets | `TwexApiTweetSearch` | `POST /twitter/advanced_search/page` |
15+
| Read a timeline page | `TwexApiUserTweetsFetcher` | `POST /twitter/{screen_name}/timeline/page` |
16+
17+
Each result becomes a Haystack `Document`. The collection is read-only. Use REST or an SDK for follower pagination and approved posting.
18+
19+
Source: [x-api-scraper-haystack](https://github.com/twexapi-dev/x-api-scraper-haystack)

twitter-api-alternatives.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ TwexAPI is an independent third-party X data API. It is not the official X API.
88

99
| Option | Strong fit | Main tradeoff |
1010
| --- | --- | --- |
11-
| TwexAPI | Filtered X data, agents, SDKs, CLI, n8n, Prefect, and X actions | Uses TwexAPI credits and documented limits |
11+
| TwexAPI | Filtered X data, agents, SDKs, CLI, n8n, Prefect, Haystack, and X actions | Uses TwexAPI credits and documented limits |
1212
| Official X API | Official platform contract and first-party support | Requires an official developer account |
1313
| Apify Actor | Console runs, schedules, and datasets | Actor and platform charges can both apply |
1414
| General scraper | Flexible HTML or browser retrieval | You own parsing, pagination, and schema drift |

0 commit comments

Comments
 (0)