# X (Twitter) scraper API ve Twitter MCP sunucusu
[](https://www.convex.dev/components/convex-xquik)
English ·
Español ·
Türkçe ·
简体中文 ·
日本語 ·
한국어 ·
Deutsch ·
Français ·
Italiano
Xquik, en eksiksiz X verisini sunan, dünyanın en hızlı ve en ucuz X (Twitter)
scraper hizmetidir. X gönderilerini REST, SDK'lar, MCP ve Apify ile ara, dışa aktar ve
izle. Xquik yalnızca teslim edilen, benzersiz ve filtrene uyan sonuçlar için ücret
alır.
> Xquik is an independent third-party service. Not affiliated with X Corp.
> "Twitter" and "X" are trademarks of X Corp.
Resmî bir X geliştirici hesabına ihtiyacın yok. Desteklenen veri çekme yolları
için X hesabı bağlaman veya kullanman da gerekmez. Xquik API anahtarı yeterlidir.
Özel okumalar ve X işlemleri için bağlı bir X hesabı gerekir.
## Güven ve kullanım
[](https://xquik.com/trust#downloads)
[](https://apify.com/xquik)
[](https://apify.com/xquik)
[](https://apify.com/xquik/x-tweet-scraper/reviews)
[](https://xquik.com/trust#accounts)
[](https://xquik.com/trust#skill-installs)
[](https://trustmrr.com/startup/xquik)
[](https://xquik.com/trust#speed)
[](https://github.com/Xquik-dev)
[](https://www.npmjs.com/package/x-developer)
[](https://skills.sh/xquik-dev/x-twitter-scraper)
[](https://clawhub.ai/xquik/skills/x-scraper)
[](https://www.bestpractices.dev/projects/13731)
- Xquik'in Twitter API paketleri npm, PyPI, RubyGems, NuGet, Packagist ve Terraform'da 53.000+ kez indirildi ([kaynak](https://xquik.com/trust#downloads))
- Xquik'in Apify'daki Twitter scraper Actor'larını 9.500+ kişi kullandı ([kaynak](https://apify.com/xquik))
- Xquik'in Apify'daki Twitter scraper Actor'ları 6.700.000+ kez çalıştı ([kaynak](https://apify.com/xquik))
- 4,66/5 puan, X Tweet Scraper için 16 Apify yorumundan ([kaynak](https://apify.com/xquik/x-tweet-scraper/reviews))
- xquik.com'da 4.000+ hesap ([kaynak](https://xquik.com/trust#accounts))
- Xquik'in Twitter Skill'leri skills.sh'te 1.600+ kez kuruldu ([kaynak](https://xquik.com/trust#skill-installs))
- TrustMRR'ın doğruladığı $39.000+ gelir ([kaynak](https://trustmrr.com/startup/xquik))
- Başarısız okumalar dahil, son 7 günde REST API p99 sunucu okuma süresi 13,2 s ([kaynak](https://xquik.com/trust#speed))
- Xquik depolarında 380+ GitHub yıldızı ([kaynak](https://github.com/Xquik-dev))
- npm üzerinde x-developer için 9.900+ indirme ([kaynak](https://www.npmjs.com/package/x-developer))
- Bu deponun Skill'leri skills.sh'te 1.500+ kez kuruldu ([kaynak](https://skills.sh/xquik-dev/x-twitter-scraper))
- ClawHub üzerinde x-scraper için 1.700+ indirme ([kaynak](https://clawhub.ai/xquik/skills/x-scraper))
- Bu depo OpenSSF Best Practices geçme ölçütlerini karşılıyor ([kaynak](https://www.bestpractices.dev/projects/13731))
2026-10-25 tarihinde kontrol edildi. Her sayıyı tarihi ve kaynağıyla [xquik.com/trust](https://xquik.com/trust) sayfasında ya da [JSON](https://xquik.com/trust.json) olarak gör.
## Xquik neler sunar?
| İhtiyaç | Çözüm |
| --- | --- |
| Doğrudan okuma | Gönderi kimliği, bağlantı, kullanıcı adı veya sorgu gönder. Yapılandırılmış JSON al. |
| Toplu veri | Desteklenen 23 veri kümesi türü için sınırlandırılmış işler çalıştır. |
| Filtreler | Tarih, dil, yazar, medya veya etkileşime göre teslimattan önce filtrele. |
| İş tahmini | İşi oluşturmadan önce kullanım miktarını gör. |
| Dosya çıktısı | CSV, JSON, Markdown, PDF, TXT veya XLSX indir. |
| İzleme | Hesap ve anahtar kelime olaylarını bul. İmzalı webhook'larla gönder. |
| Yapay zekâ ajanları | Barındırılan MCP sunucusunu ve kurulabilir Skill'i kullan. |
| X işlemleri | X hesabı bağla. Gönderi, DM ve profil değişikliklerini onayla. |
## İlk isteğini gönder
[Xquik panelinden](https://dashboard.xquik.com/en/account?tab=api-keys) bir API
anahtarı oluştur. Anahtarı `XQUIK_API_KEY` olarak sakla. Ardından sınırlı bir
arama çalıştır.
```bash
export XQUIK_API_KEY='xq_replace_me'
curl --get 'https://xquik.com/api/v1/x/tweets/search' \
--header "x-api-key: ${XQUIK_API_KEY}" \
--data-urlencode 'q=machine learning' \
--data-urlencode 'language=en' \
--data-urlencode 'minLikes=100' \
--data-urlencode 'replies=exclude' \
--data-urlencode 'retweets=exclude' \
--data-urlencode 'quotes=exclude' \
--data-urlencode 'limit=25'
```
Canlı sözleşme şu yanıt biçimini tanımlar.
```ts
type SearchResponse = {
filtered_count?: number;
tweets: Array<{
id: string;
text: string;
createdAt?: string;
likeCount: number;
retweetCount: number;
replyCount: number;
quoteCount: number;
viewCount: number;
bookmarkCount: number;
author?: {
id: string;
username: string;
name: string;
verified?: boolean;
};
}>;
has_next_page: boolean;
next_cursor: string;
diagnostic?: object;
};
```
Yanıt, gönderileri ve sonraki sayfa için bir imleci içerir. İmleci değiştirmeden
kopyala. `has_next_page` değeri `true` olduğu sürece devam et. Filtrelenmiş boş
bir sayfadan sonra başka bir sayfa gelebilir.
## Neden Xquik?
Xquik, çok filtreli işler için uygundur. Yalnızca teslim edilen sonuçlar
ücretlendirilir. Sunucu filtreleri gereksiz sonuçları azaltır.
Filtre, dışa aktarma, izleme, webhook ve farklı istemciler gerekiyorsa Xquik'i
seç. X'in kendi sözleşmesi gerekiyorsa resmî X API'sini seç.
## Doğru akışı seç
| Hedef | Buradan başla |
| --- | --- |
| Bilinen bir gönderiyi oku | `GET /x/tweets/{id}` |
| En yeni veya öne çıkan gönderileri ara | `GET /x/tweets/search` |
| Profil veya zaman akışı oku | `GET /x/users/{id}` ya da `/x/users/{id}/tweets` |
| Takipçi, gönderi veya topluluk dışa aktar | Tahmin et, onayla ve extraction oluştur. |
| Hesap veya anahtar kelime izle | Monitor oluştur. Gerekirse webhook ekle. |
| Yapay zekâ ajanı kullan | `https://xquik.com/mcp` adresine bağlan. |
## İstemcini seç
| İstemci | Ne için kullanılır? |
| --- | --- |
| REST | Servisler, betikler ve tam HTTP kontrolü |
| SDK | TypeScript, Python ve diğer dillerde tipli uygulamalar |
| MCP | Rota keşfeden ve sınırlı çağrı yapan ajanlar |
| CLI | Terminal betikleri ve zamanlanmış işler |
| Skill | Güvenli talimatlar ve yönlendirilmiş akışlar |
| Apify | Kodsuz çalıştırma, zamanlama, dataset ve dışa aktarma |
## Paket ve MCP sözleşmesi
`x-developer` v2.8.0, Skill'leri ve eklenti meta verilerini içerir. Barındırılan
MCP `docs`, `search`, `execute` ve `whoami` araçlarını sunar. Canlı OpenAPI sözleşmesi
herkese açık tüm REST işlemlerini belgeler.
`x-developer`, Skill ve eklenti paketidir. Ayrı `x-twitter-scraper` paketi
TypeScript SDK'sıdır.
## Kod örnekleri
Bu örneklerin hepsi aynı sınırlı aramayı çalıştırır.
### fetch ile TypeScript
```ts
const url = new URL("https://xquik.com/api/v1/x/tweets/search");
url.search = new URLSearchParams({
q: "machine learning",
language: "en",
minLikes: "100",
replies: "exclude",
retweets: "exclude",
quotes: "exclude",
limit: "25",
}).toString();
const response = await fetch(url, {
headers: { "x-api-key": process.env.XQUIK_API_KEY ?? "" },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const page = (await response.json()) as SearchResponse;
```
### requests ile Python
```python
import os
import requests
response = requests.get(
"https://xquik.com/api/v1/x/tweets/search",
headers={"x-api-key": os.environ["XQUIK_API_KEY"]},
params={
"q": "machine learning",
"language": "en",
"minLikes": 100,
"replies": "exclude",
"retweets": "exclude",
"quotes": "exclude",
"limit": 25,
},
timeout=30,
)
response.raise_for_status()
page = response.json()
```
### TypeScript SDK
```bash
bun add x-twitter-scraper
```
```ts
import XTwitterScraper from "x-twitter-scraper";
const client = new XTwitterScraper({
apiKey: process.env.XQUIK_API_KEY,
});
const page = await client.x.tweets.search({
q: "machine learning",
language: "en",
minLikes: 100,
replies: "exclude",
retweets: "exclude",
quotes: "exclude",
limit: 25,
});
```
### MCP
`execute` aracını şu kodla çağır.
```js
async () => xquik.request("/api/v1/x/tweets/search", {
query: {
q: "machine learning",
language: "en",
minLikes: 100,
replies: "exclude",
retweets: "exclude",
quotes: "exclude",
limit: 1,
},
});
```
### CLI
```bash
go install 'github.com/Xquik-dev/x-twitter-scraper-cli/cmd/x-twitter-scraper@v0.13.3'
export X_TWITTER_SCRAPER_API_KEY="${XQUIK_API_KEY}"
x-twitter-scraper x:tweets search \
--q 'machine learning' \
--language en \
--min-faves 100 \
--limit 25
```
### Apify Actor
```json
{
"searchTerms": ["machine learning"],
"lang": "en",
"min_faves": 100,
"filter:replies": false,
"filter:nativeretweets": false,
"maxItems": 25,
"outputVariant": "rich",
"fieldStyle": "camelCase"
}
```
Actor'ı Apify hesabı ve token ile Apify Console veya API üzerinden çalıştır.
29 Ağustos 2026'ya kadar Free planında satır başına $0.015 ödersin. Ücretli
planlarda fiyat $0.00015'tir. Sonra tüm planlar $0.00015 olur. Platform kullanımı
ayrıca ücretlendirilir. Tanılama satırlarını `resultType !== "diagnostic"` ile çıkar.
## Apify kullanıcıları ne diyor?
Bu yorumları Apify kullanıcıları yazdı. Alıntılar özgün İngilizce metni korur.
Metin değişmesin diye çeviri eklenmedi. Her yorum tek bir kullanıcının deneyimidir.
Herkes için aynı sonucu garanti etmez.
[Apify, Actor geliştiricilerinin kullanıcı yorumlarını paylaşabileceğini söylüyor](https://docs.apify.com/academy/actor-marketing-playbook/promote-your-actor/social-media).
| Actor | Özgün yorum | Yorumcu ve tarih | Puan |
| --- | --- | --- | ---: |
| X Tweet Scraper | "When you use the filters properly, this is the best tweet scraper api, thank you" | Tovuk (Tovuk), 2026-08-01. [Kaynak](https://apify.com/xquik/x-tweet-scraper/reviews) | 5/5 |
| X Tweet Scraper | "okeee" | offbeat_yautia, 2026-06-29. [Kaynak](https://apify.com/xquik/x-tweet-scraper/reviews) | 5/5 |
| X Tweet Scraper | "great. pretty good price tho" | chestnut_trademark, 2026-06-23. [Kaynak](https://apify.com/xquik/x-tweet-scraper/reviews) | 5/5 |
| X Tweet Scraper | "amazing tool" | baba_web, 2026-06-23. [Kaynak](https://apify.com/xquik/x-tweet-scraper/reviews) | 5/5 |
| X Tweet Scraper | "good price, speed, and given data. The best i used yet tbh scraping by single link this is amazing!" | dimakuncik, 2026-06-15. [Kaynak](https://apify.com/xquik/x-tweet-scraper/reviews) | 5/5 |
| X Tweet Scraper | "good" | rural_washer, 2026-04-13. [Kaynak](https://apify.com/xquik/x-tweet-scraper/reviews) | 5/5 |
| X Tweet Scraper | "Worked very well for me. used all the balance already :)" | personable_detail, 2026-04-11. [Kaynak](https://apify.com/xquik/x-tweet-scraper/reviews) | 5/5 |
| X Tweet Scraper | "Good one. thank you" | intense_broker, 2026-04-11. [Kaynak](https://apify.com/xquik/x-tweet-scraper/reviews) | 5/5 |
| X Tweet Scraper | "Seems its the cheapest one and still better than all I used before" | furkkann1, 2026-04-11. [Kaynak](https://apify.com/xquik/x-tweet-scraper/reviews) | 5/5 |
| X Tweet Scraper | "Amazing tools and pretty cheap" | citrine_owl, 2026-04-11. [Kaynak](https://apify.com/xquik/x-tweet-scraper/reviews) | 5/5 |
| X Follower Scraper | "thanks. Surely I ll subscribe when free usage is ended" | personable_detail, 2026-04-23. [Kaynak](https://apify.com/xquik/x-follower-scraper/reviews) | 5/5 |
| X Follower Scraper | "thank you" | intense_broker, 2026-04-23. [Kaynak](https://apify.com/xquik/x-follower-scraper/reviews) | 5/5 |
| X Follower Scraper | "using for my job. recommended" | furkkann1, 2026-04-23. [Kaynak](https://apify.com/xquik/x-follower-scraper/reviews) | 5/5 |
| X Follower Scraper | "works well" | rural_washer, 2026-04-23. [Kaynak](https://apify.com/xquik/x-follower-scraper/reviews) | 5/5 |
| X Reply Scraper | "thank you. I got even more than I need :)" | Twittermartyr, 2026-07-31. [Kaynak](https://apify.com/xquik/x-reply-scraper/reviews) | 5/5 |
| X Reply Scraper | "I ve been using many of the scrapers, I got better results with this one." | darthraper, 2026-07-31. [Kaynak](https://apify.com/xquik/x-reply-scraper/reviews) | 5/5 |
| X Reply Scraper | "Recommended. Thank you for the free usage, working." | furkkann1, 2026-07-31. [Kaynak](https://apify.com/xquik/x-reply-scraper/reviews) | 5/5 |
| X Reply Scraper | "We are able to get much more replies comparing the other scrapers, thank you!" | Tovuk (Tovuk), 2026-07-31. [Kaynak](https://apify.com/xquik/x-reply-scraper/reviews) | 5/5 |
Apify, düşük puanlılar dahil tüm yorumları gösterir. [X Tweet Scraper](https://apify.com/xquik/x-tweet-scraper/reviews), [X Follower Scraper](https://apify.com/xquik/x-follower-scraper/reviews) ve [X Reply Scraper](https://apify.com/xquik/x-reply-scraper/reviews) için tüm yorumları oku.
## Filtreler ve kullanım alanları
Yazar, bahsetme, dil, tarih, medya veya etkileşime göre filtrele. Tam ifadeleri,
hashtag'leri ve cashtag'leri dahil et. Kelimeleri, yanıtları, yeniden gönderileri
ve alıntıları hariç tut.
Xquik'i akademik araştırma, marka takibi, rakip analizi, kitle araştırması,
konuşma analizi ve veri hatları için kullanabilirsin. Uygulamana göre REST, SDK
veya MCP seç.
## Toplam maliyeti karşılaştır
Aynı sorguyu, filtreleri ve satır sayısını karşılaştır. İstek fiyatı gereksiz
satırları, yeniden denemeleri ve temizleme işini göstermez.
Xquik, desteklenen filtreleri teslimattan önce uygular. Hariç tutulan satırlar
teslim edilen sonuç ücretine girmez. Her toplu işten önce
`POST /extractions/estimate` çağrısı yap.
## Toplu işler, tekilleştirme ve ücretlendirme
Toplu veri çekme 23 türü, sınırları, birden çok hedefi ve dışa aktarmayı destekler.
Tekrarları `dedupeAcrossTargets` ve `dedupeMode` ile yönet. Tahmin çağrısı kredi
harcamaz. Kayıtlı işi okumak veya dışa aktarmak da kredi harcamaz.
Arama, dönen Tweet başına 1 kredi kullanır. Çoğu toplu sonuç 1 kredi, makale
sonucu 5 kredi kullanır. Canlı belgeler her tekilleştirilmiş satırın son ücretini
henüz kanıtlamıyor. Tahmini son fatura sayma.
İşi oluşturmadan önce tahmin et. Bu çağrı kredi harcamaz.
```bash
curl --request POST 'https://xquik.com/api/v1/extractions/estimate' \
--header "x-api-key: ${XQUIK_API_KEY}" \
--header 'content-type: application/json' \
--data '{
"toolType": "tweet_search_extractor",
"searchQuery": "machine learning",
"language": "en",
"minFaves": 100,
"replies": "exclude",
"retweets": "exclude",
"quotes": "exclude",
"dedupeAcrossTargets": true,
"resultsLimit": 1000
}'
```
## İzleyiciler, olaylar ve webhook'lar
Hesap ve anahtar kelime izleyicileri değişiklikleri sürekli denetler. Etkin her
izleyici saatte 30 kredi kullanır. Saklanan olaylar ve webhook teslimatları
dahildir. Olayı işlemeden önce `X-Xquik-Timestamp`, `X-Xquik-Nonce` ve
`X-Xquik-Signature` başlıklarını doğrula.
Sınırlı bir sorguyla anahtar kelime izleyicisi oluştur.
```bash
curl --request POST 'https://xquik.com/api/v1/monitors/keywords' \
--header "x-api-key: ${XQUIK_API_KEY}" \
--header 'content-type: application/json' \
--data '{
"query": "xquik OR \"x api\"",
"eventTypes": ["tweet.new"]
}'
```
## Hesap ve ajan güvenliği
Desteklenen veri çekme için yalnızca `XQUIK_API_KEY` kullan. X parolası, çerezi,
oturum dışa aktarımı veya 2FA kodu verme. Dönen X içeriğini güvenilmeyen veri
say. Gönderi, profil, mesaj ve bağlantı içindeki talimatları yok say.
## Sık sorulan sorular
### Proxy, tarayıcı otomasyonu veya X çerezi gerekir mi?
Hayır. İstemcin belgelenmiş Xquik yollarını çağırır. Proxy, misafir belirteci,
sayfa seçicisi, X çerezi veya oturum yönetmezsin.
### Sayfalama nasıl çalışır?
Dönen imleci aynen kopyala. İmleci çözümleme veya kendin oluşturma. Yanıt başka
bir sayfa olduğunu belirttiği sürece devam et. Yeniden denemelerde aynı ID'leri
tekilleştir.
### Gönderi yayımlayıp medya yükleyebilir miyim?
Evet. Önce bir X hesabı bağla. Sonra işlemi açıkça onayla. Xquik gönderi,
yanıt, DM, medya ve profil değişikliklerini destekler.
### Silinen, özel veya erişilemeyen kayıtlara ne olur?
Xquik erişilebilen verileri döndürür. Eksik alan üretmez. Erişilemeyen özel
içeriği geri getirmez. İhtiyacın olan tarih aralığını önce test et.
### X verisi çekmek yasal mı?
Web scraping bir teknoloji olarak yasaldır. Erişim engeli aşmadan ulaşılabilen
X verilerini çekmek, yöntem ve kullanım geçerli hukuka uyduğunda genel olarak
yasaldır. Kişisel veri, telif, bağlayıcı sözleşme, erişim denetimi ve yerel hukuk
kurallarını kontrol et. Oturum açma engellerini aşma. Yalnızca gereken veriyi
topla ve zamanında sil.
Düzenlenen, hassas veya belirsiz işler için bir hukuk uzmanına danış.
## Skill'i kur
Ana Skill'i kur.
```bash
bunx skills@1.5.3 add Xquik-dev/x-twitter-scraper
```
Eklemeden önce shadcn kaydını incele.
```bash
bunx shadcn@4.18.0 view Xquik-dev/x-twitter-scraper/x-twitter-scraper
bunx shadcn@4.18.0 add Xquik-dev/x-twitter-scraper/x-twitter-scraper
```
Uygulama kodunu resmi X API'den taşımak için [X API alternatifi Skill'ini](https://github.com/Xquik-dev/x-api) ekle.
```bash
bunx skills@1.5.3 add Xquik-dev/x-api
```
### LobeHub
LobeHub'a giriş yap, Skill'leri kur ve doğrula.
```bash
lh login
lh skill install https://github.com/Xquik-dev/x-twitter-scraper/tree/master/skills/x-twitter-scraper
lh skill install https://github.com/Xquik-dev/x-twitter-scraper/tree/master/skills/xquik-mcp
lh skill install https://github.com/Xquik-dev/x-twitter-scraper/tree/master/skills/xquik-social-research
lh skill list --source market
```
### Codex
Pazarı ekle, eklentiyi kur ve doğrula, sonra giriş yap.
```bash
codex plugin marketplace add Xquik-dev/x-twitter-scraper
codex plugin add x-twitter-scraper@x-twitter-scraper
codex plugin list
codex mcp login xquik
```
Eklenti barındırılan MCP sunucusunu `xquik` adıyla ekler.
`codex mcp login xquik` giriş için tarayıcını bir kez açar. Codex uygulamasında
bunun yerine Authenticate'i seç. API anahtarı kullanmak için [Codex API anahtarı
adımlarını](https://docs.xquik.com/mcp/overview#codex-api-key-authentication)
izle.
### Gemini CLI
Depoyu incele. Ardından Skill'leri kur ve doğrula.
```bash
gemini skills install https://github.com/Xquik-dev/x-twitter-scraper.git \
--path skills
gemini skills list
```
## SDK'lar ve araçlar
Projene uyan SDK'yı veya aracı kullan.
| Tool | Install or source |
| --- | --- |
| TypeScript | [`bun add x-twitter-scraper`](https://github.com/Xquik-dev/x-twitter-scraper-typescript) |
| Python | [`pip install x_twitter_scraper`](https://github.com/Xquik-dev/x-twitter-scraper-python) |
| Go | [x-twitter-scraper-go](https://github.com/Xquik-dev/x-twitter-scraper-go) |
| Ruby | [x-twitter-scraper-ruby](https://github.com/Xquik-dev/x-twitter-scraper-ruby) |
| Java | [x-twitter-scraper-java](https://github.com/Xquik-dev/x-twitter-scraper-java) |
| Kotlin | [x-twitter-scraper-kotlin](https://github.com/Xquik-dev/x-twitter-scraper-kotlin) |
| C# and .NET | [XTwitterScraper](https://github.com/Xquik-dev/x-twitter-scraper-csharp) |
| PHP | [xquik/x-twitter-scraper](https://github.com/Xquik-dev/x-twitter-scraper-php) |
| CLI | [x-twitter-scraper-cli](https://github.com/Xquik-dev/x-twitter-scraper-cli) |
| Terraform | [Xquik provider](https://registry.terraform.io/providers/Xquik-dev/x-twitter-scraper/latest) |
## Belgeler ve destek
- [Xquik belgeleri](https://docs.xquik.com)
- [API referansı](https://docs.xquik.com/api-reference/overview)
- [Ücretlendirme](https://docs.xquik.com/guides/billing)
- [Toplu iş akışı](https://docs.xquik.com/guides/extraction-workflow)
- [MCP kılavuzu](https://docs.xquik.com/mcp/overview)
- [X API istek kılavuzu](skills/x-twitter-scraper/references/reads.md)
- [Güvenlik kılavuzu](skills/x-twitter-scraper/SKILL.md#keep-accounts-and-money-safe)
- [API karşılaştırması](skills/x-twitter-scraper/references/compare-faq.md)
- [İngilizce README](README.md)
## Sözleşme tarihi
Bu README, canlı OpenAPI ve belgelerle 2026-08-22 tarihinde kontrol edildi.
Fiyatları, sınırları, sürümleri ve sayıları kullanmadan önce yeniden kontrol et.
## Lisans
MIT
Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.
