Social Posts by IDs

GET /gateway/v1/social/tweets

Social Posts by IDs

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/social/tweets

200

{
  "data": [
    {
      "author": {
        "handle": "<string>",
        "name": "<string>",
        "user_id": "<string>",
        "avatar": "<string>"
      },
      "created_at": 123,
      "stats": {
        "likes": 123,
        "replies": 123,
        "reposts": 123,
        "views": 123
      },
      "text": "<string>",
      "tweet_id": "<string>",
      "url": "<string>",
      "media": [
        {
          "type": "<string>",
          "url": "<string>"
        }
      ]
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "https://example.com/schemas/DataResponseXTweet.json"
}

Query Parameters

ids · string · required

Comma-separated numeric post ID strings, max 100

Example:

"1880293339000000000,1880293339000000001"

Response

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseXTweet.json"