tweets

Tweets by id, batch

Up to 100 tweets in one call. 1 credit per tweet found; deleted or private tweets are listed in errors and cost nothing. Results in input order. Also GET /v1/tweets/batch?ids=20,21.

post/v1/tweets/batch

Request

  • Base URL: https://api.xdataapi.io
  • URL: https://api.xdataapi.io/v1/tweets/batch
  • Auth: one of:
    • API key in header x-api-key
    • OAuth 2 (authorization code, authorization URL https://xdataapi.io/oauth/authorize, token URL https://xdataapi.io/api/oauth/token, scopes: read)

Query parameters

freshboolean

Bypass the cache. Costs 2x credits.

Request body

idsstring[] required

Example request

{
  "ids": [
    "20",
    "1968000000000000000"
  ]
}

Response

OK

itemsinteger required

Objects returned.

credits_chargednumber required
balance_remainingnumber required
cache'miss' | 'hit' | 'mixed' | 'bypass' required
cache_hitsinteger required

Objects served from cache

request_idstring uuid required

Example response

{
  "data": [
    {
      "id": "20",
      "author": {
        "id": "783214",
        "handle": "X"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.