Search API \ Search tweets on Twitter

Resource/URI HTTP GET
Twitter · Search tweets /search/twitter/tweets.json Search
Tweets

Workflow

Request: the code to send to the API

Send a GET request to the endpoint /search/twitter/tweets.json to return a collection of Tweets matching a specified query.

To be able to use this endpoint Twitter must be fully configured for your OneAll Site.

The following URL parameters can optionally be used with this endpoint.

URL Parameter Description
* search_text
string
Free-form text to match. Can be text or username (ie. @oneall).
num_tweets
integer
Indicates how many tweets should be included in the resultset. The valid range is between 1 an 200.
Default: 50
until_tweet_id
integer
If specified, only tweets having an id less than this value are returned. To paginate the resultset, simply read the first page, note the id of the last entry and then make another request by using it's value for until_tweet_id.
Example: 1060488451450195969
after_tweet_id
integer
If specified, only tweets having an id greater than this value are returned. Example: 1060488451450195969
result_type
string
If specified, return a type of results which can be "mixed", "recent" or "popular". By default, the results type is "mixed."
language
string
If specified, return only tweets of specified language. Must be an ISO 639-1 code
Example: fr

Result: the code returned by the API

Response Example

{
  "response": {
    "request": {
      "date": "Thu, 03 Jan 2019 11:35:33  0100",
      "resource": "/search/twitter/tweets.json?search_text=OneAll",
      "status": {
        "flag": "success",
        "code": 200,
        "info": "Your request has been processed successfully"
      }
    },
    "result": {
      "data": {
        "count": 2,
        "entries": [
          {
            "id": 975676099354071040,
            "url": "https://twitter.com/OneAll/status/975676099354071040",
            "date": "Mon, 19 Mar 2018 11:11:23 +0100",
            "text": "@OneAll Hi, Discord is available on MyBB for OneAll. You can download it on our GitHub repo here : https://t.co/8NIILcigSJ",
            "type": "reply",
            "num_retweets": 0,
            "num_favorites": 1,
            "links": [
              {
                "url": "https://twitter.com/i/web/status/975676099354071040",
                "url_short": "https://t.co/8NIILcigSJ"
              }
            ],
            "place": 
              {
                "id": "61490a94f1b5dde4",
                "url": "https://api.twitter.com/1.1/geo/id/61490a94f1b5dde4.json",
                "place_type": "city",
                "name": "Abreu e Lima",
                "full_name": "Abreu e Lima, Brasil",
                "country_code": "BR",
                "country": "Brazil"
              }
          },
          {
            "id": 941650483214798848,
            "url": "https://twitter.com/OneAll/status/941650483214798848",
            "date": "Fri, 15 Dec 2017 13:45:44 +0100",
            "text": "RT Do you use OneAll (@OneAll) and recommend 👍 them? You can do it here 👉 https://t.co/1AcxlFkGlp 🚀",
            "type": "retweet",
            "num_retweets": 123,
            "num_favorites": 4,
            "links": [
              {
                "url": "https://twitter.com/i/web/status/941650483214798848",
                "url_short": "https://t.co/1AcxlFkGlp"
              }
            ]
          }
        ]
      }
    }
  }
}

User Contributed Notes