Skip to main content
Help us improve Python packaging – donate today!

Twitter Search CLI

Project Description

# ts

![Screen Shot](screenshot.png)

Twitter Search CLI

## Install

pip install ts

## Usage

Before actual usage, you need to initialize config file first:

ts --init

The first time you run ts, it will guide you through an OAuth authentication process.
The tokens will be stored at `~/.ts.config.json`, any time you want refresh the tokens, run:

ts --auth

to make authentication again and update the tokens in config.

The search syntax is the same as [Twitter Web Search]( or
[Twitter Search API](
Here are some common search query examples:

1. Find what a person had said:

ts 'from:NASA Elon Musk'

2. Find what people said to a person in a topic:

ts '#Hearthstone to:bdbrode'

Run `ts -h` to see complete usage instructions:

usage: ts [-c COUNT] [-l LANG] [--link] [-d] QUERY
ts [--init|--auth|--config CONFIG] [-d]

Twitter Search CLI

Search options:
QUERY search query, see:
-c COUNT set result number, by default it's 50
-l LANG set search language (en, zh-cn), see:

Display options:
--link append link with tweet
-d enable debug log
-dd debug deeper (more verbose)

Other options:
--init init config file
--auth make authentication with twitter
--config {proxy} config ts, support arguments: `proxy`
-h, --help show this help message and exit

## Proxy

ts supports proxying, you can set proxy by run ``ts --config proxy``,
a proxy address is something like `http://localhost:1000` or ``.

Note that by default ts only supports HTTP(S) proxying, if you want to use socks5 proxy,
you'll need to install `requests[socks]` before using it. For more information see
[requests document](

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ts-0.4.3-py2-none-any.whl (13.8 kB) Copy SHA256 hash SHA256 Wheel 2.7 Aug 31, 2016
ts-0.4.3.tar.gz (10.8 kB) Copy SHA256 hash SHA256 Source None Aug 31, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page