I'm looking for document about scoped_timeline


#1

Hi, All.

I can’t find below URL
https://dev.twitter.com/ads/reference/1/get/accounts/:account_id/scoped_timeline

I want to check parameters, about “scoped_to”.

Please tell me.


#2

@ikono: Thanks for letting us know about this page. We’ll restore it as soon as possible.

In terms of the scoped_to parameter, you can use:

  • followers (default) to find Tweets in the account’s timeline or
  • none to find Promoted-Only Tweets

Here is an example request, scoping the results to just Promoted-Only Tweets:

$ twurl -H ads-api.twitter.com "/1/accounts/18ce54d4x5t/scoped_timeline?scoped_to=none&trim_user=true" | jq
{
  "data_type": "status",
  "data": [
    {
      "created_at": "Thu Sep 22 23:32:09 +0000 2016",
      "id": 779101005849829400,
      "id_str": "779101005849829376",
      "text": "hello, @furni",
      "truncated": false,
      "entities": {
        "hashtags": [],
        "symbols": [],
        "user_mentions": [
          {
            "screen_name": "furni",
            "name": "Furni",
            "id": 3805104374,
            "id_str": "3805104374",
            "indices": [
              7,
              13
            ]
          }
        ],
        "urls": []
      },
      "source": {source},
      "in_reply_to_status_id": null,
      "in_reply_to_status_id_str": null,
      "in_reply_to_user_id": null,
      "in_reply_to_user_id_str": null,
      "in_reply_to_screen_name": null,
      "user": {
        "id": 756201191646691300,
        "id_str": "756201191646691328"
      },
      "geo": null,
      "coordinates": null,
      "place": null,
      "contributors": [
        2417045708
      ],
      "retweet_count": 0,
      "favorite_count": 0,
      "favorited": false,
      "retweeted": false,
      "scopes": {
        "followers": false
      },
      "lang": "en"
    },
    ...
  ],
  "next_cursor": null,
  "request": {
    "params": {
      "trim_user": true,
      "scoped_to": "none",
      "account_id": "18ce54d4x5t"
    }
  }
}

#3

Thanks for your replying and examples. @juanshishido


#4

@ikono: We’ll let you know once the documentation is updated. Please consider marking this thread as solved once we’ve provided what you were looking for.


#5

I confirmed “GET accounts/:account_id/scoped_timeline” link updated.

Thanks.