twarc

Command-line and Python tools for archiving Twitter/X data.

Runs as twarc|macOS, Linux, Windows|twarc-project.readthedocs.io

Command form

ai-draft · 2 tasks · 6 fields

Collect tweets with the v1.1 twarc command. Only search is modelled; filter, timeline, hydrate and the premium-archive options are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui twarc

`twarc search`

Search tweets

Search recent tweets. Output goes to stdout; redirect it to a .jsonl file in the shell.

Search tweetsExample values, fixed in this page — nothing here reaches a terminal

Basic

Query*

string

Language (ISO 639-1)

string

Maximum tweets

integer

TasksEach one presets the form for one job

Search a query

querylanglimit

Search near a location

querygeocodelimit

ParametersOnly these flags are editable in the form

Query

Search terms, for example '#blacklivesmatter OR #blm'. Optional when a geocode is given.
string · positional 0

Language (ISO 639-1)

string

--lang

Geocode

latitude,longitude,radius, for example 38.7442,-90.3054,1mi.
string

--geocode

From date

string

--from_date

To date

string

--to_date

Maximum tweets

integer

--limit

SourcesEvery flag above is checked against these

docs

twarc search blacklivesmatter > tweets.jsonl twarc search '#blacklivesmatter' --lang fr > tweets.jsonl twarc search blacklivesmatter --geocode 38.7442,-90.3054,1mi > tweets.jsonl If a search query isn't supplied when using --geocode you will get all tweets relevant for that location and radius you will likely want to limit the time range using --to_date and…

manual2026-10-27

twarc-project.readthedocs.io

Before it fills your prompt, Otty checks the installed twarc against its version. A form that does not match your version is not offered.