Item API

指定したtab内のアイテム一覧を指定された順序で返却する。 contains_id が指定された場合、該当のアイテムが含まれるページ内のアイテム一覧が返却される。この際 page および area_id パラメータは無視され、 sort には recent が指定されたものとみなされる。 contans_id が指定されない場合、sort には以下の2種類を指定できる。 - popular : 人気順でレスポンスされる - recent : 更新日時が新しい順でレスポンスされる認証済みの場合でかつ、該当アイテムが自分のtabに入っている場合のみ、各 item 内の要素として is_tabbed: true が返される。 include_expired によって、有効期間が過ぎているアイテムを含むかどうかを指定できる。 - true : 有効期間外のアイテム（始まる前、終わった後）を含む。 - false : 有効期間が過ぎているアイテムは含まれない。（始まる前のアイテムは含まれる）（参考 : アイテムの有効期間について） * 旧API仕様との互換性 * sortへ long or middle or short を指定した場合、sort=popularとして処理される

Parameters

Key	Value	デフォルト値
stream_id	取得対象tabのID
sort	並び順を指定する。 popular, recent のいずれか	popular
contains_id	該当IDのアイテムを含むページを取得する場合に指定する
area_id	該当IDのエリアに属するアイテムのみを取得する場合に指定する
include_expired	有効期間外のアイテムを返却するかどうか	ログイン状態でかつユーザ自身のtabが指定された場合はtrue, そうでなければfalse
page	取得するページ番号。1 <= page	1
limit	1ページに含む要素の数。 1 <= limit <= 100	100

Request

Route

GET /api/1/streams/359760447/items.json?sort=recent

Headers

Host: example.org
Cookie: 
Origin:

Query Parameters

sort: recent

Response

Headers

Content-Type: application/json; charset=utf-8
Set-Cookie: guest_distinct_id=8913f2ad-4440-44b3-b380-3cb86cc4ca26; expires=Mon, 09-Jan-2023 01:54:09 GMT
THIS_IS_SESSION_COOKIE_KEY_FOR_SPEC=BAh7B0kiD3Nlc3Npb25faWQGOgZFRkkiJTcwZTgzY2ZiZjBmYWQ3YzdhNGVmOWRhOTczMDIzMmNkBjsAVEkiGGtwaV9wcmV2X2NvbnRyb2xsZXIGOwBGSSIYYXBpL2l0ZW1zI2J5X3N0cmVhbQY7AEY%3D--cb01ab23aa1d39f05d8706d5655ddeb6d21b1d9d; path=/; HttpOnly
X-Ua-Compatible: IE=Edge,chrome=1
E-Tag: "09a6d4e02227f592ed03cdd54b117b95"
Cache-Control: max-age=0, private, must-revalidate
X-Request: 781151d9cb40582eb75cc6894b1101da
X-Runtime: 0.144407
Content-Length: 5465

Status

200 OK

Body

フォーマット: items/paginated_list

{
  "total": 2,
  "page": 1,
  "limit": 100,
  "items": [
    {
      "id": 566302110,
      "title": "iguchi の渋谷アイテム",
      "reclip_from_id": null,
      "reclip_count": 1,
      "like_count": 2,
      "origin_id": null,
      "link_url": "http://example.com/items/1",
      "created_at": "2013-01-08T23:54:03Z",
      "updated_at": "2013-01-09T01:54:09Z",
      "description": "素敵なお店",
      "starting_date": null,
      "ending_date": null,
      "image_urls": [
        {
          "original": "http://not-real.s3.amazonaws.com/images/original/f72a75c77675cb0f3452b176cd0232c12ccab759.png?1357696443",
          "crop_S": "http://not-real.s3.amazonaws.com/images/crop_S/967f6ad0e57b9cdc251676fa6a89ac2a26e7b6b6.jpg?1357696443",
          "crop_M": "http://not-real.s3.amazonaws.com/images/crop_M/0078d956d348c740241a5f81a50c0fbd7abe65b4.jpg?1357696443",
          "crop_M1": "http://not-real.s3.amazonaws.com/images/crop_M1/93c649fc2462a2cb87d82d608f2cef5c015d0883.jpg?1357696443",
          "crop_M2": "http://not-real.s3.amazonaws.com/images/crop_M2/dd53d388a6a6c06cb6a38de3e645443778e38973.jpg?1357696443",
          "crop_L": "http://not-real.s3.amazonaws.com/images/crop_L/ba1e73a5d5c95b6683f18f217adccb09e5bb3dc6.jpg?1357696443",
          "crop_LL": "http://not-real.s3.amazonaws.com/images/crop_LL/d553d7013c1bbc39a963b1bda6d834b25fb8d4a5.jpg?1357696443",
          "normal_L": "http://not-real.s3.amazonaws.com/images/normal_L/4a6dd79cb1be896e2c70e5b1bae5dd86743fde6d.jpg?1357696443",
          "normal_LL": "http://not-real.s3.amazonaws.com/images/normal_LL/736c95fda936e55fdc881fa36d41872a1d39fed5.jpg?1357696443"
        }
      ],
      "site_url": "http://tab.do/items/566302110",
      "user": {
        "id": 974211560,
        "screen_name": "Iguchi Takahito",
        "profile_image_url": {
          "original": "http://sc2-items-dev.s3.amazonaws.com/profile_images/original/missing.png?t=1",
          "crop_S": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_S/missing.png?t=1",
          "crop_M": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_M/missing.png?t=1",
          "crop_M1": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_M1/missing.png?t=1",
          "crop_M2": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_M2/missing.png?t=1",
          "crop_L": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_L/missing.png?t=1",
          "crop_LL": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_LL/missing.png?t=1",
          "normal_L": "http://sc2-items-dev.s3.amazonaws.com/profile_images/normal_L/missing.png?t=1",
          "normal_LL": "http://sc2-items-dev.s3.amazonaws.com/profile_images/normal_LL/missing.png?t=1"
        }
      },
      "places": [
        {
          "id": 446688635,
          "name": "ハチ公前",
          "address": "東京都渋谷区道玄坂1-1-1",
          "description": null,
          "lon": 139.70056861639023,
          "lat": 35.65906149699357,
          "created_at": "2013-01-09T01:54:04Z",
          "updated_at": "2013-01-09T01:54:04Z"
        }
      ],
      "area": {
        "id": 317713213,
        "name": "渋谷駅"
      },
      "stream": {
        "id": 359760447,
        "title": "iguchiのお気に入り",
        "followers_count": 1,
        "description": "お気に入りの数々",
        "latest_used": "2013-01-09T01:54:09Z"
      }
    },
    {
      "id": 833889656,
      "title": "オリジナル渋谷",
      "reclip_from_id": null,
      "reclip_count": 0,
      "like_count": 0,
      "origin_id": null,
      "link_url": "http://example.com/items/8",
      "created_at": "2013-01-09T01:54:03Z",
      "updated_at": "2013-01-09T01:54:03Z",
      "description": "ステキなお店",
      "starting_date": null,
      "ending_date": null,
      "image_urls": [
        {
          "original": "http://not-real.s3.amazonaws.com/images/original/f72a75c77675cb0f3452b176cd0232c12ccab759.png?1357696443",
          "crop_S": "http://not-real.s3.amazonaws.com/images/crop_S/967f6ad0e57b9cdc251676fa6a89ac2a26e7b6b6.jpg?1357696443",
          "crop_M": "http://not-real.s3.amazonaws.com/images/crop_M/0078d956d348c740241a5f81a50c0fbd7abe65b4.jpg?1357696443",
          "crop_M1": "http://not-real.s3.amazonaws.com/images/crop_M1/93c649fc2462a2cb87d82d608f2cef5c015d0883.jpg?1357696443",
          "crop_M2": "http://not-real.s3.amazonaws.com/images/crop_M2/dd53d388a6a6c06cb6a38de3e645443778e38973.jpg?1357696443",
          "crop_L": "http://not-real.s3.amazonaws.com/images/crop_L/ba1e73a5d5c95b6683f18f217adccb09e5bb3dc6.jpg?1357696443",
          "crop_LL": "http://not-real.s3.amazonaws.com/images/crop_LL/d553d7013c1bbc39a963b1bda6d834b25fb8d4a5.jpg?1357696443",
          "normal_L": "http://not-real.s3.amazonaws.com/images/normal_L/4a6dd79cb1be896e2c70e5b1bae5dd86743fde6d.jpg?1357696443",
          "normal_LL": "http://not-real.s3.amazonaws.com/images/normal_LL/736c95fda936e55fdc881fa36d41872a1d39fed5.jpg?1357696443"
        }
      ],
      "site_url": "http://tab.do/items/833889656",
      "user": {
        "id": 974211560,
        "screen_name": "Iguchi Takahito",
        "profile_image_url": {
          "original": "http://sc2-items-dev.s3.amazonaws.com/profile_images/original/missing.png?t=1",
          "crop_S": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_S/missing.png?t=1",
          "crop_M": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_M/missing.png?t=1",
          "crop_M1": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_M1/missing.png?t=1",
          "crop_M2": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_M2/missing.png?t=1",
          "crop_L": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_L/missing.png?t=1",
          "crop_LL": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_LL/missing.png?t=1",
          "normal_L": "http://sc2-items-dev.s3.amazonaws.com/profile_images/normal_L/missing.png?t=1",
          "normal_LL": "http://sc2-items-dev.s3.amazonaws.com/profile_images/normal_LL/missing.png?t=1"
        }
      },
      "places": [
        {
          "id": 446688635,
          "name": "ハチ公前",
          "address": "東京都渋谷区道玄坂1-1-1",
          "description": null,
          "lon": 139.70056861639023,
          "lat": 35.65906149699357,
          "created_at": "2013-01-09T01:54:04Z",
          "updated_at": "2013-01-09T01:54:04Z"
        }
      ],
      "stream": {
        "id": 359760447,
        "title": "iguchiのお気に入り",
        "followers_count": 1,
        "description": "お気に入りの数々",
        "latest_used": "2013-01-09T01:54:09Z"
      }
    }
  ]
}

Item API : List items in a tab

Parameters

Request

Route

Headers

Query Parameters

Response

Headers

Status

Body