Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
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 History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
ts-0.4.3-py2-none-any.whl (13.8 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Aug 31, 2016
ts-0.4.3.tar.gz (10.8 kB) Copy SHA256 Checksum SHA256 Source Aug 31, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting