Scweet avatar

Scweet

Try for free

Pay $0.30 for 1,000 tweets

Go to Store
Scweet

Scweet

altimis/scweet
Try for free

Pay $0.30 for 1,000 tweets

Scweet is a scalable tweet-scraping tool built on the open-source Scweet library. Just specify dates, keywords, hashtags, and tweet count—the Actor automatically scales to fetch data at up to 1000 tweets per minute only $0.30 per 1000 tweets. All results come in JSON/CSV format.

You can access the Scweet programmatically from your own applications by using the Apify API. You can 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": "1.0",
5    "x-build-id": "9obX7eQxQNuhZ6jwX"
6  },
7  "servers": [
8    {
9      "url": "https://api.apify.com/v2"
10    }
11  ],
12  "paths": {
13    "/acts/altimis~scweet/run-sync-get-dataset-items": {
14      "post": {
15        "operationId": "run-sync-get-dataset-items-altimis-scweet",
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/altimis~scweet/runs": {
50      "post": {
51        "operationId": "runs-sync-altimis-scweet",
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/altimis~scweet/run-sync": {
93      "post": {
94        "operationId": "run-sync-altimis-scweet",
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          "words_and": {
135            "title": "Words (AND)",
136            "type": "array",
137            "description": "Each word in this list must appear in the tweet. The word shouldn't contain Spaces.",
138            "default": [],
139            "items": {
140              "type": "string"
141            }
142          },
143          "words_or": {
144            "title": "Words (OR)",
145            "type": "array",
146            "description": "At least one of these words must appear in the tweet. The word shouldn't contain Spaces.",
147            "default": [],
148            "items": {
149              "type": "string"
150            }
151          },
152          "hashtag": {
153            "title": "Hashtags",
154            "type": "array",
155            "description": "List of hashtags to include in the search.",
156            "default": [],
157            "items": {
158              "type": "string"
159            }
160          },
161          "since": {
162            "title": "Since (Start Date)",
163            "type": "string",
164            "description": "Select start date for tweets to scrape (YYYY-MM-DD)."
165          },
166          "until": {
167            "title": "Until (End Date)",
168            "type": "string",
169            "description": "Select end date for tweets to scrape (YYYY-MM-DD)."
170          },
171          "maxItems": {
172            "title": "Max Tweets",
173            "type": "string",
174            "description": "Maximum number of tweets to attempt to retrieve.",
175            "default": "1000"
176          },
177          "from_user": {
178            "title": "From User",
179            "type": "string",
180            "description": "Scrape tweets from this user (no @). If no words/hashtags were given, the output will contain all the tweets posted by this user in the given date interval.",
181            "default": ""
182          },
183          "to_user": {
184            "title": "To User",
185            "type": "string",
186            "description": "Scrape tweets directed to or replying to this user.",
187            "default": ""
188          },
189          "type": {
190            "title": "Search Type",
191            "enum": [
192              "Top",
193              "Latest"
194            ],
195            "type": "string",
196            "description": "Type of tweets to fetch: 'Top' or 'Latest'.",
197            "default": "Top"
198          },
199          "lang": {
200            "title": "Language",
201            "enum": [
202              "en",
203              "ab",
204              "aa",
205              "af",
206              "ak",
207              "sq",
208              "am",
209              "ar",
210              "an",
211              "hy",
212              "as",
213              "av",
214              "ae",
215              "ay",
216              "az",
217              "bm",
218              "ba",
219              "eu",
220              "be",
221              "bn",
222              "bh",
223              "bi",
224              "bs",
225              "br",
226              "bg",
227              "my",
228              "ca",
229              "ch",
230              "ce",
231              "ny",
232              "zh",
233              "cv",
234              "kw",
235              "co",
236              "cr",
237              "hr",
238              "cs",
239              "da",
240              "dv",
241              "nl",
242              "eo",
243              "et",
244              "ee",
245              "fo",
246              "fj",
247              "fi",
248              "fr",
249              "ff",
250              "gl",
251              "ka",
252              "de",
253              "el",
254              "gn",
255              "gu",
256              "ht",
257              "ha",
258              "he",
259              "iw",
260              "hz",
261              "hi",
262              "ho",
263              "hu",
264              "ia",
265              "id",
266              "ie",
267              "ga",
268              "ig",
269              "ik",
270              "io",
271              "is",
272              "it",
273              "iu",
274              "ja",
275              "jv",
276              "kl",
277              "kn",
278              "kr",
279              "ks",
280              "kk",
281              "km",
282              "ki",
283              "rw",
284              "ky",
285              "kv",
286              "kg",
287              "ko",
288              "ku",
289              "kj",
290              "la",
291              "lb",
292              "lg",
293              "li",
294              "ln",
295              "lo",
296              "lt",
297              "lu",
298              "lv",
299              "gv",
300              "mk",
301              "mg",
302              "ms",
303              "ml",
304              "mt",
305              "mi",
306              "mr",
307              "mh",
308              "mn",
309              "na",
310              "nv",
311              "nb",
312              "nd",
313              "ne",
314              "ng",
315              "nn",
316              "no",
317              "ii",
318              "nr",
319              "oc",
320              "oj",
321              "cu",
322              "om",
323              "or",
324              "os",
325              "pa",
326              "pi",
327              "fa",
328              "pl",
329              "ps",
330              "pt",
331              "qu",
332              "rm",
333              "rn",
334              "ro",
335              "ru",
336              "sa",
337              "sc",
338              "sd",
339              "se",
340              "sm",
341              "sg",
342              "sr",
343              "gd",
344              "sn",
345              "si",
346              "sk",
347              "sl",
348              "so",
349              "st",
350              "es",
351              "su",
352              "sw",
353              "ss",
354              "sv",
355              "ta",
356              "te",
357              "tg",
358              "th",
359              "ti",
360              "bo",
361              "tk",
362              "tl",
363              "tn",
364              "to",
365              "tr",
366              "ts",
367              "tt",
368              "tw",
369              "ty",
370              "ug",
371              "uk",
372              "ur",
373              "uz",
374              "ve",
375              "vi",
376              "vo",
377              "wa",
378              "cy",
379              "wo",
380              "fy",
381              "xh",
382              "yi",
383              "yo",
384              "za"
385            ],
386            "type": "string",
387            "description": "Restrict tweets by language (e.g. 'en').",
388            "default": "en"
389          },
390          "verified": {
391            "title": "Verified users only",
392            "type": "boolean",
393            "description": "Filter only tweets with verified users",
394            "default": false
395          },
396          "blue_verified": {
397            "title": "Blue-verified users only",
398            "type": "boolean",
399            "description": "Filter only tweets with blue_verified users",
400            "default": false
401          },
402          "retweets": {
403            "title": "Only retweets",
404            "type": "boolean",
405            "description": "Filter only retweets for other tweets",
406            "default": false
407          },
408          "replies": {
409            "title": "Only replies",
410            "type": "boolean",
411            "description": "Filter only replies to other tweets",
412            "default": false
413          },
414          "mentions": {
415            "title": "Only tweets with mentions",
416            "type": "boolean",
417            "description": "Filter only tweets with mentions",
418            "default": false
419          },
420          "hashtags": {
421            "title": "Only tweets with hashtags",
422            "type": "boolean",
423            "description": "Filter only tweets with hashtags",
424            "default": false
425          },
426          "images": {
427            "title": "Only Images",
428            "type": "boolean",
429            "description": "Filter only tweets that contain images",
430            "default": false
431          },
432          "videos": {
433            "title": "Only Videos",
434            "type": "boolean",
435            "description": "Filter only tweets that contain videos",
436            "default": false
437          },
438          "min_likes": {
439            "title": "Minimum Likes",
440            "type": "string",
441            "description": "Minimum number of likes required (e.g. '10').",
442            "default": ""
443          },
444          "min_replies": {
445            "title": "Minimum Replies",
446            "type": "string",
447            "description": "Minimum number of replies required.",
448            "default": ""
449          },
450          "min_retweets": {
451            "title": "Minimum Retweets",
452            "type": "string",
453            "description": "Minimum number of retweets required.",
454            "default": ""
455          },
456          "geocode": {
457            "title": "Geocode",
458            "type": "string",
459            "description": "Geolocation parameter, e.g. '39.8283,-98.5795,2500km'.",
460            "default": ""
461          },
462          "place": {
463            "title": "Place ID",
464            "type": "string",
465            "description": "Place ID for area-based search (e.g. '96683cc9126741d1').",
466            "default": ""
467          },
468          "near": {
469            "title": "Near (City)",
470            "type": "string",
471            "description": "Name of city or location, e.g. 'Paris'.",
472            "default": ""
473          }
474        }
475      },
476      "runsResponseSchema": {
477        "type": "object",
478        "properties": {
479          "data": {
480            "type": "object",
481            "properties": {
482              "id": {
483                "type": "string"
484              },
485              "actId": {
486                "type": "string"
487              },
488              "userId": {
489                "type": "string"
490              },
491              "startedAt": {
492                "type": "string",
493                "format": "date-time",
494                "example": "2025-01-08T00:00:00.000Z"
495              },
496              "finishedAt": {
497                "type": "string",
498                "format": "date-time",
499                "example": "2025-01-08T00:00:00.000Z"
500              },
501              "status": {
502                "type": "string",
503                "example": "READY"
504              },
505              "meta": {
506                "type": "object",
507                "properties": {
508                  "origin": {
509                    "type": "string",
510                    "example": "API"
511                  },
512                  "userAgent": {
513                    "type": "string"
514                  }
515                }
516              },
517              "stats": {
518                "type": "object",
519                "properties": {
520                  "inputBodyLen": {
521                    "type": "integer",
522                    "example": 2000
523                  },
524                  "rebootCount": {
525                    "type": "integer",
526                    "example": 0
527                  },
528                  "restartCount": {
529                    "type": "integer",
530                    "example": 0
531                  },
532                  "resurrectCount": {
533                    "type": "integer",
534                    "example": 0
535                  },
536                  "computeUnits": {
537                    "type": "integer",
538                    "example": 0
539                  }
540                }
541              },
542              "options": {
543                "type": "object",
544                "properties": {
545                  "build": {
546                    "type": "string",
547                    "example": "latest"
548                  },
549                  "timeoutSecs": {
550                    "type": "integer",
551                    "example": 300
552                  },
553                  "memoryMbytes": {
554                    "type": "integer",
555                    "example": 1024
556                  },
557                  "diskMbytes": {
558                    "type": "integer",
559                    "example": 2048
560                  }
561                }
562              },
563              "buildId": {
564                "type": "string"
565              },
566              "defaultKeyValueStoreId": {
567                "type": "string"
568              },
569              "defaultDatasetId": {
570                "type": "string"
571              },
572              "defaultRequestQueueId": {
573                "type": "string"
574              },
575              "buildNumber": {
576                "type": "string",
577                "example": "1.0.0"
578              },
579              "containerUrl": {
580                "type": "string"
581              },
582              "usage": {
583                "type": "object",
584                "properties": {
585                  "ACTOR_COMPUTE_UNITS": {
586                    "type": "integer",
587                    "example": 0
588                  },
589                  "DATASET_READS": {
590                    "type": "integer",
591                    "example": 0
592                  },
593                  "DATASET_WRITES": {
594                    "type": "integer",
595                    "example": 0
596                  },
597                  "KEY_VALUE_STORE_READS": {
598                    "type": "integer",
599                    "example": 0
600                  },
601                  "KEY_VALUE_STORE_WRITES": {
602                    "type": "integer",
603                    "example": 1
604                  },
605                  "KEY_VALUE_STORE_LISTS": {
606                    "type": "integer",
607                    "example": 0
608                  },
609                  "REQUEST_QUEUE_READS": {
610                    "type": "integer",
611                    "example": 0
612                  },
613                  "REQUEST_QUEUE_WRITES": {
614                    "type": "integer",
615                    "example": 0
616                  },
617                  "DATA_TRANSFER_INTERNAL_GBYTES": {
618                    "type": "integer",
619                    "example": 0
620                  },
621                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
622                    "type": "integer",
623                    "example": 0
624                  },
625                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
626                    "type": "integer",
627                    "example": 0
628                  },
629                  "PROXY_SERPS": {
630                    "type": "integer",
631                    "example": 0
632                  }
633                }
634              },
635              "usageTotalUsd": {
636                "type": "number",
637                "example": 0.00005
638              },
639              "usageUsd": {
640                "type": "object",
641                "properties": {
642                  "ACTOR_COMPUTE_UNITS": {
643                    "type": "integer",
644                    "example": 0
645                  },
646                  "DATASET_READS": {
647                    "type": "integer",
648                    "example": 0
649                  },
650                  "DATASET_WRITES": {
651                    "type": "integer",
652                    "example": 0
653                  },
654                  "KEY_VALUE_STORE_READS": {
655                    "type": "integer",
656                    "example": 0
657                  },
658                  "KEY_VALUE_STORE_WRITES": {
659                    "type": "number",
660                    "example": 0.00005
661                  },
662                  "KEY_VALUE_STORE_LISTS": {
663                    "type": "integer",
664                    "example": 0
665                  },
666                  "REQUEST_QUEUE_READS": {
667                    "type": "integer",
668                    "example": 0
669                  },
670                  "REQUEST_QUEUE_WRITES": {
671                    "type": "integer",
672                    "example": 0
673                  },
674                  "DATA_TRANSFER_INTERNAL_GBYTES": {
675                    "type": "integer",
676                    "example": 0
677                  },
678                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
679                    "type": "integer",
680                    "example": 0
681                  },
682                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
683                    "type": "integer",
684                    "example": 0
685                  },
686                  "PROXY_SERPS": {
687                    "type": "integer",
688                    "example": 0
689                  }
690                }
691              }
692            }
693          }
694        }
695      }
696    }
697  }
698}

Scweet on Apify: Fast and unlimited Tweets 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 Scweet 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:

Developer
Maintained by Community

Actor Metrics

  • 19 monthly users

  • 3 stars

  • >99% runs succeeded

  • Created in Dec 2024

  • Modified 3 days ago