GET users/search

GET	`https://api.twitter.com/1.1/users/search.json?q=Twitter%20API&page=1&count=3`

```
[
```
```
  {
```

    "profile_sidebar_fill_color": "DDEEF6",

```
    "profile_background_tile": true,
```

    "profile_sidebar_border_color": "C0DEED",

```
    "name": "Twitter API",
```

    "created_at": "Wed May 23 06:01:13 +0000 2007",

    "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",

```
    "location": "San Francisco, CA",
```
```
    "follow_request_sent": false,
```
```
    "id_str": "6253282",
```
```
    "is_translator": false,
```
```
    "profile_link_color": "0084B4",
```
```
    "entities": {
```
```
      "url": {
```
```
        "urls": [
```
```
          {
```
```
            "expanded_url": null,
```

            "url": "http://dev.twitter.com",

```
            "indices": [
```
```
              0,
```
```
              22
```
```
            ],
```
```
            "display_url": null
```
```
          }
```
```
        ]
```
```
      },
```
```
      "description": {
```
```
        "urls": [
```
```
 
```
```
        ]
```
```
      }
```
```
    },
```
```
    "default_profile": false,
```
```
    "contributors_enabled": false,
```
```
    "favourites_count": 25,
```
```
    "url": "http://dev.twitter.com",
```

    "profile_banner_url": "https://twimg0-a.akamaihd.net/profile_banners/6253282/1347394302",

```
    "utc_offset": -28800,
```

    "profile_image_url_https": "https://twimg0-a.akamaihd.net/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",

```
    "id": 6253282,
```
```
    "listed_count": 11426,
```

    "profile_use_background_image": true,

```
    "lang": "en",
```
```
    "profile_text_color": "333333",
```
```
    "followers_count": 1562132,
```
```
    "protected": false,
```
```
    "verified": true,
```

    "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.",

```
    "geo_enabled": true,
```

    "time_zone": "Pacific Time (US & Canada)",

```
    "notifications": false,
```

    "profile_background_image_url_https": "https://twimg0-a.akamaihd.net/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",

    "profile_background_color": "C0DEED",

```
    "status": {
```
```
      "coordinates": null,
```
```
      "truncated": false,
```
```
      "favorited": false,
```

      "created_at": "Wed Mar 27 01:19:47 +0000 2013",

```
      "id_str": "316721175038406658",
```
```
      "entities": {
```
```
        "urls": [
```
```
 
```
```
        ],
```
```
        "hashtags": [
```
```
 
```
```
        ],
```
```
        "user_mentions": [
```
```
          {
```
```
            "name": "TwitterDevJP",
```
```
            "id_str": "70915829",
```
```
            "id": 70915829,
```
```
            "indices": [
```
```
              106,
```
```
              119
```
```
            ],
```

            "screen_name": "TwitterDevJP"

```
          }
```
```
        ]
```
```
      },
```
```
      "in_reply_to_user_id_str": null,
```

      "text": "In case you didn't know, we have an official account tweeting about Twitter developer topics in Japanese: @TwitterDevJP",

```
      "contributors": null,
```
```
      "id": 316721175038406658,
```

      "in_reply_to_status_id_str": null,

```
      "retweet_count": 19,
```
```
      "geo": null,
```
```
      "retweeted": false,
```
```
      "in_reply_to_user_id": null,
```
```
      "source": "web",
```
```
      "place": null,
```
```
      "in_reply_to_screen_name": null,
```
```
      "in_reply_to_status_id": null
```
```
    },
```
```
    "friends_count": 34,
```

    "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",

```
    "default_profile_image": false,
```
```
    "statuses_count": 3406,
```
```
    "screen_name": "twitterapi",
```
```
    "following": true
```
```
  },
```
```
  {
```

    "profile_sidebar_fill_color": "DDEEF6",

```
    "profile_background_tile": true,
```

    "profile_sidebar_border_color": "C0DEED",

```
    "name": "Twitter Mobile",
```

    "created_at": "Tue Apr 10 01:20:52 +0000 2007",

    "profile_image_url": "http://a0.twimg.com/profile_images/2284174879/uqyatg9dtld0rxx9anic_normal.png",

```
    "location": "San Francisco, CA",
```
```
    "is_translator": false,
```
```
    "follow_request_sent": false,
```
```
    "id_str": "3963481",
```
```
    "profile_link_color": "0084B4",
```
```
    "entities": {
```
```
      "url": {
```
```
        "urls": [
```
```
          {
```
```
            "expanded_url": null,
```

            "url": "http://twitter.com",

```
            "indices": [
```
```
              0,
```
```
              18
```
```
            ],
```
```
            "display_url": null
```
```
          }
```
```
        ]
```
```
      },
```
```
      "description": {
```
```
        "urls": [
```
```
 
```
```
        ]
```
```
      }
```
```
    },
```
```
    "default_profile": false,
```
```
    "contributors_enabled": false,
```
```
    "favourites_count": 2,
```
```
    "url": "http://twitter.com",
```

    "profile_image_url_https": "https://twimg0-a.akamaihd.net/profile_images/2284174879/uqyatg9dtld0rxx9anic_normal.png",

    "profile_banner_url": "https://twimg0-a.akamaihd.net/profile_banners/3963481/1347394599",

```
    "utc_offset": -28800,
```
```
    "id": 3963481,
```
```
    "listed_count": 7303,
```

    "profile_use_background_image": true,

```
    "lang": "en",
```
```
    "profile_text_color": "333333",
```
```
    "followers_count": 2359548,
```
```
    "protected": false,
```
```
    "verified": true,
```
```
    "description": null,
```
```
    "geo_enabled": true,
```

    "time_zone": "Pacific Time (US & Canada)",

```
    "notifications": false,
```

    "profile_background_image_url_https": "https://twimg0-a.akamaihd.net/profile_background_images/656932170/urr667rpqtg6l7psohaf.png",

    "profile_background_color": "C0DEED",

```
    "status": {
```
```
      "coordinates": null,
```
```
      "truncated": false,
```
```
      "favorited": false,
```

      "created_at": "Wed Mar 20 12:55:51 +0000 2013",

```
      "id_str": "314359633311588355",
```
```
      "in_reply_to_user_id_str": null,
```
```
      "entities": {
```
```
        "urls": [
```
```
 
```
```
        ],
```
```
        "hashtags": [
```
```
 
```
```
        ],
```
```
        "user_mentions": [
```
```
 
```
```
        ]
```
```
      },
```

      "text": "Beeline subscribers in Armenia can now send and receive Tweets via SMS. Begin by sending START to 40404. Welcome to Twitter!",

```
      "contributors": null,
```
```
      "id": 314359633311588355,
```

      "in_reply_to_status_id_str": null,

```
      "retweet_count": 31,
```
```
      "geo": null,
```
```
      "retweeted": false,
```
```
      "in_reply_to_user_id": null,
```
```
      "source": "web",
```
```
      "place": null,
```
```
      "in_reply_to_screen_name": null,
```
```
      "in_reply_to_status_id": null
```
```
    },
```
```
    "friends_count": 28,
```

    "profile_background_image_url": "http://a0.twimg.com/profile_background_images/656932170/urr667rpqtg6l7psohaf.png",

```
    "default_profile_image": false,
```
```
    "statuses_count": 338,
```
```
    "screen_name": "twittermobile",
```
```
    "following": true
```
```
  },
```
```
  {
```

    "profile_sidebar_fill_color": "DAECF4",

```
    "profile_background_tile": false,
```

    "profile_sidebar_border_color": "C6E2EE",

```
    "name": "Twitter Engineering",
```

    "created_at": "Sat Jun 16 00:14:36 +0000 2007",

    "profile_image_url": "http://a0.twimg.com/profile_images/2284174594/apcu4c9tu2zkefnev0jt_normal.png",

```
    "location": "San Francisco, CA",
```
```
    "follow_request_sent": false,
```
```
    "is_translator": false,
```
```
    "id_str": "6844292",
```
```
    "profile_link_color": "1F98C7",
```
```
    "entities": {
```
```
      "url": {
```
```
        "urls": [
```
```
          {
```
```
            "expanded_url": null,
```

            "url": "http://engineering.twitter.com",

```
            "indices": [
```
```
              0,
```
```
              30
```
```
            ],
```
```
            "display_url": null
```
```
          }
```
```
        ]
```
```
      },
```
```
      "description": {
```
```
        "urls": [
```
```
 
```
```
        ]
```
```
      }
```
```
    },
```
```
    "default_profile": false,
```
```
    "contributors_enabled": false,
```
```
    "favourites_count": 0,
```

    "url": "http://engineering.twitter.com",

    "profile_image_url_https": "https://twimg0-a.akamaihd.net/profile_images/2284174594/apcu4c9tu2zkefnev0jt_normal.png",

```
    "utc_offset": -28800,
```
```
    "id": 6844292,
```
```
    "listed_count": 2304,
```

    "profile_use_background_image": true,

```
    "lang": "en",
```
```
    "profile_text_color": "663B12",
```
```
    "followers_count": 343156,
```
```
    "protected": false,
```
```
    "verified": true,
```

    "description": "The official account for Twitter Engineering.",

```
    "geo_enabled": true,
```

    "time_zone": "Pacific Time (US & Canada)",

```
    "notifications": false,
```

    "profile_background_image_url_https": "https://twimg0-a.akamaihd.net/images/themes/theme2/bg.gif",

    "profile_background_color": "C6E2EE",

```
    "status": {
```
```
      "coordinates": null,
```
```
      "truncated": false,
```
```
      "favorited": false,
```

      "created_at": "Mon Mar 18 17:50:28 +0000 2013",

```
      "id_str": "313708997167419393",
```
```
      "retweeted_status": {
```
```
        "coordinates": null,
```
```
        "truncated": false,
```
```
        "favorited": false,
```

        "created_at": "Thu Mar 14 10:57:20 +0000 2013",

```
        "id_str": "312155480858431488",
```

        "in_reply_to_user_id_str": null,

```
        "entities": {
```
```
          "urls": [
```
```
            {
```

              "expanded_url": "http://tweetdeck.posterous.com/flight-at-tweetdeck",

              "url": "http://t.co/G9sRrGHgJY",

```
              "indices": [
```
```
                56,
```
```
                78
```
```
              ],
```

              "display_url": "tweetdeck.posterous.com/flight-at-twee…"

```
            }
```
```
          ],
```
```
          "hashtags": [
```
```
 
```
```
          ],
```
```
          "user_mentions": [
```
```
 
```
```
          ]
```
```
        },
```

        "text": "Our use of the Flight JavaScript framework in TweetDeck http://t.co/G9sRrGHgJY",

```
        "contributors": null,
```
```
        "id": 312155480858431488,
```

        "in_reply_to_status_id_str": null,

```
        "retweet_count": 100,
```
```
        "geo": null,
```
```
        "retweeted": false,
```
```
        "in_reply_to_user_id": null,
```
```
        "possibly_sensitive": false,
```

        "source": "<a href=\"http://www.tweetdeck.com\" rel=\"nofollow\">TweetDeck</a>",

```
        "place": null,
```

        "in_reply_to_screen_name": null,

```
        "in_reply_to_status_id": null
```
```
      },
```
```
      "in_reply_to_user_id_str": null,
```
```
      "entities": {
```
```
        "urls": [
```
```
          {
```

            "expanded_url": "http://tweetdeck.posterous.com/flight-at-tweetdeck",

            "url": "http://t.co/G9sRrGHgJY",

```
            "indices": [
```
```
              71,
```
```
              93
```
```
            ],
```

            "display_url": "tweetdeck.posterous.com/flight-at-twee…"

```
          }
```
```
        ],
```
```
        "hashtags": [
```
```
 
```
```
        ],
```
```
        "user_mentions": [
```
```
          {
```
```
            "name": "TweetDeck",
```
```
            "id_str": "14803701",
```
```
            "id": 14803701,
```
```
            "indices": [
```
```
              3,
```
```
              13
```
```
            ],
```
```
            "screen_name": "TweetDeck"
```
```
          }
```
```
        ]
```
```
      },
```

      "text": "RT @TweetDeck: Our use of the Flight JavaScript framework in TweetDeck http://t.co/G9sRrGHgJY",

```
      "contributors": null,
```
```
      "id": 313708997167419393,
```

      "in_reply_to_status_id_str": null,

```
      "retweet_count": 100,
```
```
      "geo": null,
```
```
      "retweeted": false,
```
```
      "in_reply_to_user_id": null,
```
```
      "possibly_sensitive": false,
```
```
      "source": "web",
```
```
      "place": null,
```
```
      "in_reply_to_screen_name": null,
```
```
      "in_reply_to_status_id": null
```
```
    },
```
```
    "friends_count": 0,
```

    "profile_background_image_url": "http://a0.twimg.com/images/themes/theme2/bg.gif",

```
    "default_profile_image": false,
```
```
    "statuses_count": 153,
```
```
    "screen_name": "TwitterEng",
```
```
    "following": true
```
```
  }
```
```
]
```

Rate Limited?	Yes
Requests per rate limit window	180/user
Authentication	Requires user context
Response Formats	json
HTTP Methods	GET
Resource family	users
Response Object	Users
API Version	v1.1

GET users/search

Resource URL

Parameters

Example Request

Resource Information

OAuth tool

Related Documentation

Tags