X (Twitter) Search Scraper
Pricing
$30.00/month + usage
Go to Store
X (Twitter) Search Scraper
web.harvester/easy-twitter-search-scraper
Easily extract tweets from X (Twitter) search results with our powerful Twitter Search Scraper. Get full tweet data, including text, engagement, media, and user info. Export in JSON, CSV, Excel, or HTML—perfect for social media monitoring, market research, competitor analysis, and trend tracking.
3.2 (9)
Pricing
$30.00/month + usage
68
Monthly users
188
Runs succeeded
>99%
Response time
45 days
Last modified
4 days ago
You can access the X (Twitter) Search Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
1{
2 "openapi": "3.0.1",
3 "info": {
4 "version": "0.1",
5 "x-build-id": "AmlBQOzGNRh5QPJAW"
6 },
7 "servers": [
8 {
9 "url": "https://api.apify.com/v2"
10 }
11 ],
12 "paths": {
13 "/acts/web.harvester~easy-twitter-search-scraper/run-sync-get-dataset-items": {
14 "post": {
15 "operationId": "run-sync-get-dataset-items-web.harvester-easy-twitter-search-scraper",
16 "x-openai-isConsequential": false,
17 "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
18 "tags": [
19 "Run Actor"
20 ],
21 "requestBody": {
22 "required": true,
23 "content": {
24 "application/json": {
25 "schema": {
26 "$ref": "#/components/schemas/inputSchema"
27 }
28 }
29 }
30 },
31 "parameters": [
32 {
33 "name": "token",
34 "in": "query",
35 "required": true,
36 "schema": {
37 "type": "string"
38 },
39 "description": "Enter your Apify token here"
40 }
41 ],
42 "responses": {
43 "200": {
44 "description": "OK"
45 }
46 }
47 }
48 },
49 "/acts/web.harvester~easy-twitter-search-scraper/runs": {
50 "post": {
51 "operationId": "runs-sync-web.harvester-easy-twitter-search-scraper",
52 "x-openai-isConsequential": false,
53 "summary": "Executes an Actor and returns information about the initiated run in response.",
54 "tags": [
55 "Run Actor"
56 ],
57 "requestBody": {
58 "required": true,
59 "content": {
60 "application/json": {
61 "schema": {
62 "$ref": "#/components/schemas/inputSchema"
63 }
64 }
65 }
66 },
67 "parameters": [
68 {
69 "name": "token",
70 "in": "query",
71 "required": true,
72 "schema": {
73 "type": "string"
74 },
75 "description": "Enter your Apify token here"
76 }
77 ],
78 "responses": {
79 "200": {
80 "description": "OK",
81 "content": {
82 "application/json": {
83 "schema": {
84 "$ref": "#/components/schemas/runsResponseSchema"
85 }
86 }
87 }
88 }
89 }
90 }
91 },
92 "/acts/web.harvester~easy-twitter-search-scraper/run-sync": {
93 "post": {
94 "operationId": "run-sync-web.harvester-easy-twitter-search-scraper",
95 "x-openai-isConsequential": false,
96 "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
97 "tags": [
98 "Run Actor"
99 ],
100 "requestBody": {
101 "required": true,
102 "content": {
103 "application/json": {
104 "schema": {
105 "$ref": "#/components/schemas/inputSchema"
106 }
107 }
108 }
109 },
110 "parameters": [
111 {
112 "name": "token",
113 "in": "query",
114 "required": true,
115 "schema": {
116 "type": "string"
117 },
118 "description": "Enter your Apify token here"
119 }
120 ],
121 "responses": {
122 "200": {
123 "description": "OK"
124 }
125 }
126 }
127 }
128 },
129 "components": {
130 "schemas": {
131 "inputSchema": {
132 "type": "object",
133 "properties": {
134 "searchQueries": {
135 "title": "Search queries",
136 "type": "array",
137 "description": "This lets you specify a list of search queries to use. The scraper will use these queries to search for tweets.",
138 "items": {
139 "type": "string"
140 }
141 },
142 "tweetsDesired": {
143 "title": "Maximum number of tweets (per query).",
144 "type": "integer",
145 "description": "",
146 "default": 100
147 },
148 "repliesDepth": {
149 "title": "Replies depth (Read the description!)",
150 "minimum": 0,
151 "maximum": 20,
152 "type": "integer",
153 "description": "How many levels of replies should be scraped. 0 means no replies, 1 means the tweet and its replies, 2 means the tweet, its replies and the replies of the replies, etc."
154 },
155 "includeUserInfo": {
156 "title": "Include the profile user info in every tweet result (Now will get userId!)",
157 "type": "boolean",
158 "description": "This will add the profile user info to every tweet result. This is useful if you want to scrape tweets from multiple profiles and want to know which profile each tweet belongs to. This will be slower!",
159 "default": true
160 },
161 "since": {
162 "title": "Tweets newer than (since)",
163 "type": "string",
164 "description": "This lets you specify the oldest date of tweets to extract, format <code>YYYY-MM-DD</code>. You can also use relative dates such as '1 month' or '2 days' instead of absolute dates such as '2020-02-29'."
165 },
166 "until": {
167 "title": "Tweets older than (until)",
168 "type": "string",
169 "description": "This lets you specify the newest date of tweets to extract, format <code>YYYY-MM-DD</code>. You can also use relative dates such as '1 month' or '2 days' instead of absolute dates such as '2020-02-29'."
170 },
171 "minReplies": {
172 "title": "Minimum number of replies",
173 "minimum": 0,
174 "type": "integer",
175 "description": "Minimum number of replies a tweet must have to be scraped.",
176 "default": 0
177 },
178 "minRetweets": {
179 "title": "Minimum number of retweets",
180 "minimum": 0,
181 "type": "integer",
182 "description": "Minimum number of retweets a tweet must have to be scraped.",
183 "default": 0
184 },
185 "minLikes": {
186 "title": "Minimum number of likes",
187 "minimum": 0,
188 "type": "integer",
189 "description": "Minimum number of likes a tweet must have to be scraped.",
190 "default": 0
191 },
192 "fromTheseAccounts": {
193 "title": "From these accounts",
194 "type": "array",
195 "description": "Scrape tweets from these accounts.",
196 "default": [],
197 "items": {
198 "type": "string"
199 }
200 },
201 "toTheseAccounts": {
202 "title": "To these accounts",
203 "type": "array",
204 "description": "Scrape tweets to these accounts.",
205 "default": [],
206 "items": {
207 "type": "string"
208 }
209 },
210 "mentioningTheseAccounts": {
211 "title": "Mentioning these accounts",
212 "type": "array",
213 "description": "Scrape tweets mentioning these accounts.",
214 "default": [],
215 "items": {
216 "type": "string"
217 }
218 },
219 "nativeRetweets": {
220 "title": "Include only native retweets",
221 "type": "boolean",
222 "description": "This will include only native retweets in the results. Native retweets are tweets that have been retweeted without comment.",
223 "default": false
224 },
225 "media": {
226 "title": "Include only tweets with media",
227 "type": "boolean",
228 "description": "This will include only tweets that contain media (images, videos, gifs, etc.)",
229 "default": false
230 },
231 "images": {
232 "title": "Include only tweets with images",
233 "type": "boolean",
234 "description": "This will include only tweets that contain images",
235 "default": false
236 },
237 "videos": {
238 "title": "Include only tweets with videos",
239 "type": "boolean",
240 "description": "This will include only tweets that contain videos",
241 "default": false
242 },
243 "news": {
244 "title": "Include only tweets with news",
245 "type": "boolean",
246 "description": "This will include only tweets that contain news",
247 "default": false
248 },
249 "verified": {
250 "title": "Include only tweets from verified users",
251 "type": "boolean",
252 "description": "This will include only tweets from verified users",
253 "default": false
254 },
255 "nativeVideo": {
256 "title": "Include only tweets with native video",
257 "type": "boolean",
258 "description": "This will include only tweets that contain native video",
259 "default": false
260 },
261 "replies": {
262 "title": "Include only replies",
263 "type": "boolean",
264 "description": "This will include only replies to tweets",
265 "default": false
266 },
267 "links": {
268 "title": "Include only tweets with links",
269 "type": "boolean",
270 "description": "This will include only tweets that contain links",
271 "default": false
272 },
273 "safe": {
274 "title": "Include only tweets marked as potentially sensitive",
275 "type": "boolean",
276 "description": "This will include only tweets that have been marked as potentially sensitive",
277 "default": false
278 },
279 "quote": {
280 "title": "Include only tweets that quote other tweets",
281 "type": "boolean",
282 "description": "This will include only tweets that quote other tweets",
283 "default": false
284 },
285 "proVideo": {
286 "title": "Include only tweets with pro video",
287 "type": "boolean",
288 "description": "This will include only tweets that contain pro video",
289 "default": false
290 },
291 "excludeNativeRetweets": {
292 "title": "Exclude native retweets",
293 "type": "boolean",
294 "description": "This will exclude native retweets in the results. Native retweets are tweets that have been retweeted without comment.",
295 "default": false
296 },
297 "excludeMedia": {
298 "title": "Exclude tweets with media",
299 "type": "boolean",
300 "description": "This will exclude tweets that contain media (images, videos, gifs, etc.)",
301 "default": false
302 },
303 "excludeImages": {
304 "title": "Exclude tweets with images",
305 "type": "boolean",
306 "description": "This will exclude tweets that contain images",
307 "default": false
308 },
309 "excludeVideos": {
310 "title": "Exclude tweets with videos",
311 "type": "boolean",
312 "description": "This will exclude tweets that contain videos",
313 "default": false
314 },
315 "excludeNews": {
316 "title": "Exclude tweets with news",
317 "type": "boolean",
318 "description": "This will exclude tweets that contain news",
319 "default": false
320 },
321 "excludeVerified": {
322 "title": "Exclude tweets from verified users",
323 "type": "boolean",
324 "description": "This will exclude tweets from verified users",
325 "default": false
326 },
327 "excludeNativeVideo": {
328 "title": "Exclude tweets with native video",
329 "type": "boolean",
330 "description": "This will exclude tweets that contain native video",
331 "default": false
332 },
333 "excludeReplies": {
334 "title": "Exclude replies",
335 "type": "boolean",
336 "description": "This will exclude replies to tweets",
337 "default": false
338 },
339 "excludeLinks": {
340 "title": "Exclude tweets with links",
341 "type": "boolean",
342 "description": "This will exclude tweets that contain links",
343 "default": false
344 },
345 "excludeSafe": {
346 "title": "Exclude tweets marked as potentially sensitive",
347 "type": "boolean",
348 "description": "This will exclude tweets that have been marked as potentially sensitive",
349 "default": false
350 },
351 "excludeQuote": {
352 "title": "Exclude tweets that quote other tweets",
353 "type": "boolean",
354 "description": "This will exclude tweets that quote other tweets",
355 "default": false
356 },
357 "excludeProVideo": {
358 "title": "Exclude tweets with pro video",
359 "type": "boolean",
360 "description": "This will exclude tweets that contain pro video",
361 "default": false
362 },
363 "language": {
364 "title": "Tweets language",
365 "enum": [
366 "any",
367 "ar",
368 "ar-x-fm",
369 "bn",
370 "eu",
371 "bg",
372 "ca",
373 "hr",
374 "cs",
375 "da",
376 "nl",
377 "en",
378 "fi",
379 "fr",
380 "de",
381 "el",
382 "gu",
383 "he",
384 "hi",
385 "hu",
386 "id",
387 "it",
388 "ja",
389 "kn",
390 "ko",
391 "mr",
392 "no",
393 "fa",
394 "pl",
395 "pt",
396 "ro",
397 "ru",
398 "sr",
399 "zh-cn",
400 "sk",
401 "sl",
402 "es",
403 "sv",
404 "ta",
405 "th",
406 "zh-tw",
407 "tr",
408 "uk",
409 "ur",
410 "vi"
411 ],
412 "type": "string",
413 "description": "Scrape tweets in a specific language.",
414 "default": "any"
415 },
416 "near": {
417 "title": "Near location",
418 "type": "string",
419 "description": "This lets you specify a location (e.g. a city) to search near"
420 },
421 "textLengthLessThan": {
422 "title": "Text length less than",
423 "type": "integer",
424 "description": "This lets you specify the maximum length of the tweet text"
425 },
426 "proxyConfig": {
427 "title": "Proxy configuration (RESIDENTIAL recommended)",
428 "type": "object",
429 "description": "",
430 "default": {
431 "useApifyProxy": true,
432 "apifyProxyGroups": [
433 "RESIDENTIAL"
434 ]
435 }
436 }
437 }
438 },
439 "runsResponseSchema": {
440 "type": "object",
441 "properties": {
442 "data": {
443 "type": "object",
444 "properties": {
445 "id": {
446 "type": "string"
447 },
448 "actId": {
449 "type": "string"
450 },
451 "userId": {
452 "type": "string"
453 },
454 "startedAt": {
455 "type": "string",
456 "format": "date-time",
457 "example": "2025-01-08T00:00:00.000Z"
458 },
459 "finishedAt": {
460 "type": "string",
461 "format": "date-time",
462 "example": "2025-01-08T00:00:00.000Z"
463 },
464 "status": {
465 "type": "string",
466 "example": "READY"
467 },
468 "meta": {
469 "type": "object",
470 "properties": {
471 "origin": {
472 "type": "string",
473 "example": "API"
474 },
475 "userAgent": {
476 "type": "string"
477 }
478 }
479 },
480 "stats": {
481 "type": "object",
482 "properties": {
483 "inputBodyLen": {
484 "type": "integer",
485 "example": 2000
486 },
487 "rebootCount": {
488 "type": "integer",
489 "example": 0
490 },
491 "restartCount": {
492 "type": "integer",
493 "example": 0
494 },
495 "resurrectCount": {
496 "type": "integer",
497 "example": 0
498 },
499 "computeUnits": {
500 "type": "integer",
501 "example": 0
502 }
503 }
504 },
505 "options": {
506 "type": "object",
507 "properties": {
508 "build": {
509 "type": "string",
510 "example": "latest"
511 },
512 "timeoutSecs": {
513 "type": "integer",
514 "example": 300
515 },
516 "memoryMbytes": {
517 "type": "integer",
518 "example": 1024
519 },
520 "diskMbytes": {
521 "type": "integer",
522 "example": 2048
523 }
524 }
525 },
526 "buildId": {
527 "type": "string"
528 },
529 "defaultKeyValueStoreId": {
530 "type": "string"
531 },
532 "defaultDatasetId": {
533 "type": "string"
534 },
535 "defaultRequestQueueId": {
536 "type": "string"
537 },
538 "buildNumber": {
539 "type": "string",
540 "example": "1.0.0"
541 },
542 "containerUrl": {
543 "type": "string"
544 },
545 "usage": {
546 "type": "object",
547 "properties": {
548 "ACTOR_COMPUTE_UNITS": {
549 "type": "integer",
550 "example": 0
551 },
552 "DATASET_READS": {
553 "type": "integer",
554 "example": 0
555 },
556 "DATASET_WRITES": {
557 "type": "integer",
558 "example": 0
559 },
560 "KEY_VALUE_STORE_READS": {
561 "type": "integer",
562 "example": 0
563 },
564 "KEY_VALUE_STORE_WRITES": {
565 "type": "integer",
566 "example": 1
567 },
568 "KEY_VALUE_STORE_LISTS": {
569 "type": "integer",
570 "example": 0
571 },
572 "REQUEST_QUEUE_READS": {
573 "type": "integer",
574 "example": 0
575 },
576 "REQUEST_QUEUE_WRITES": {
577 "type": "integer",
578 "example": 0
579 },
580 "DATA_TRANSFER_INTERNAL_GBYTES": {
581 "type": "integer",
582 "example": 0
583 },
584 "DATA_TRANSFER_EXTERNAL_GBYTES": {
585 "type": "integer",
586 "example": 0
587 },
588 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
589 "type": "integer",
590 "example": 0
591 },
592 "PROXY_SERPS": {
593 "type": "integer",
594 "example": 0
595 }
596 }
597 },
598 "usageTotalUsd": {
599 "type": "number",
600 "example": 0.00005
601 },
602 "usageUsd": {
603 "type": "object",
604 "properties": {
605 "ACTOR_COMPUTE_UNITS": {
606 "type": "integer",
607 "example": 0
608 },
609 "DATASET_READS": {
610 "type": "integer",
611 "example": 0
612 },
613 "DATASET_WRITES": {
614 "type": "integer",
615 "example": 0
616 },
617 "KEY_VALUE_STORE_READS": {
618 "type": "integer",
619 "example": 0
620 },
621 "KEY_VALUE_STORE_WRITES": {
622 "type": "number",
623 "example": 0.00005
624 },
625 "KEY_VALUE_STORE_LISTS": {
626 "type": "integer",
627 "example": 0
628 },
629 "REQUEST_QUEUE_READS": {
630 "type": "integer",
631 "example": 0
632 },
633 "REQUEST_QUEUE_WRITES": {
634 "type": "integer",
635 "example": 0
636 },
637 "DATA_TRANSFER_INTERNAL_GBYTES": {
638 "type": "integer",
639 "example": 0
640 },
641 "DATA_TRANSFER_EXTERNAL_GBYTES": {
642 "type": "integer",
643 "example": 0
644 },
645 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
646 "type": "integer",
647 "example": 0
648 },
649 "PROXY_SERPS": {
650 "type": "integer",
651 "example": 0
652 }
653 }
654 }
655 }
656 }
657 }
658 }
659 }
660 }
661}X (Twitter) Search Scraper OpenAPI definition
OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for X (Twitter) Search Scraper from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients:
Pricing
Pricing model
RentalTo use this Actor, you have to pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage.
Free trial
6 hours
Price
$30.00
