Post Streams

• Retrieve the Global stream
• Retrieve Posts created by a User
• Retrieve Posts mentioning a User
• Retrieve a User’s personalized stream
• Retrieve a User’s unified stream
• Retrieve tagged Posts

Retrieve the Global stream

Return the 20 most recent Posts from the Global stream.

This endpoint responds to general Post parameters.

Responses from this endpoint are paginated.

Endpoint

Method	URL	Token
GET	https://alpha-api.app.net/stream/0/posts/stream/global	None

Example

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/posts/stream/global"

{
  "data": [
    {
      "canonical_url": "https://alpha.app.net/adn/post/914440",
      "created_at": "2012-10-11T19:48:40Z",
      "entities": {
        "hashtags": [
          {
            "len": 8,
            "name": "adnhack",
            "pos": 90
          }
        ],
        "links": [
          {
            "len": 29,
            "pos": 100,
            "text": "http://appnet.eventbrite.com/",
            "url": "http://appnet.eventbrite.com/"
          }
        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first <span data-hashtag-name=\"adnhack\" itemprop=\"hashtag\">#adnhack</span> => <a href=\"http://appnet.eventbrite.com/\">http://appnet.eventbrite.com/</a></span>",
      "id": "914440",
      "machine_only": false,
      "num_replies": 1,
      "num_reposts": 3,
      "num_stars": 3,
      "source": {
        "client_id": "caYWDBvjwt2e9HWMm6qyKS6KcATHUkzQ",
        "link": "https://alpha.app.net",
        "name": "Alpha"
      },
      "text": "If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first #adnhack => http://appnet.eventbrite.com/",
      "thread_id": "914440",
      "user": "...user object...",
      "you_reposted": false,
      "you_starred": false,
      "pagination_id": "914440"
    }
  ],
  "meta": {
    "code": 200,
    "more": false,
    "min_id": "914440",
    "max_id": "914440"
  }
}

Retrieve Posts created by a User

Get the most recent Posts created by a specific User in reverse post order.

This endpoint responds to general Post parameters.

Responses from this endpoint are paginated.

Endpoint

Method	URL	Token
GET	https://alpha-api.app.net/stream/0/users/{user_id}/posts	None

URL Parameters

Name	Description
user_id	The user id. If the user id is me the current authenticated user will be used. You can also specify @username as a user_id.

Example

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/users/1558/posts"

{
  "data": [
    {
      "canonical_url": "https://alpha.app.net/adn/post/914440",
      "created_at": "2012-10-11T19:48:40Z",
      "entities": {
        "hashtags": [
          {
            "len": 8,
            "name": "adnhack",
            "pos": 90
          }
        ],
        "links": [
          {
            "len": 29,
            "pos": 100,
            "text": "http://appnet.eventbrite.com/",
            "url": "http://appnet.eventbrite.com/"
          }
        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first <span data-hashtag-name=\"adnhack\" itemprop=\"hashtag\">#adnhack</span> => <a href=\"http://appnet.eventbrite.com/\">http://appnet.eventbrite.com/</a></span>",
      "id": "914440",
      "machine_only": false,
      "num_replies": 1,
      "num_reposts": 3,
      "num_stars": 3,
      "source": {
        "client_id": "caYWDBvjwt2e9HWMm6qyKS6KcATHUkzQ",
        "link": "https://alpha.app.net",
        "name": "Alpha"
      },
      "text": "If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first #adnhack => http://appnet.eventbrite.com/",
      "thread_id": "914440",
      "user": "...user object...",
      "you_reposted": false,
      "you_starred": false,
      "pagination_id": "914440"
    }
  ],
  "meta": {
    "code": 200,
    "more": false,
    "min_id": "914440",
    "max_id": "914440"
  }
}

Retrieve Posts mentioning a User

Get the most recent Posts mentioning by a specific User in reverse post order.

This endpoint responds to general Post parameters.

Responses from this endpoint are paginated.

Endpoint

Method	URL	Token
GET	https://alpha-api.app.net/stream/0/users/{user_id}/mentions	Any

URL Parameters

Name	Description
user_id	The user id. If the user id is me the current authenticated user will be used. You can also specify @username as a user_id.

Example

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/users/2/mentions"

{
  "data": [
    {
      "canonical_url": "https://alpha.app.net/adn/post/914440",
      "created_at": "2012-10-11T19:48:40Z",
      "entities": {
        "hashtags": [
          {
            "len": 8,
            "name": "adnhack",
            "pos": 90
          }
        ],
        "links": [
          {
            "len": 29,
            "pos": 100,
            "text": "http://appnet.eventbrite.com/",
            "url": "http://appnet.eventbrite.com/"
          }
        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first <span data-hashtag-name=\"adnhack\" itemprop=\"hashtag\">#adnhack</span> => <a href=\"http://appnet.eventbrite.com/\">http://appnet.eventbrite.com/</a></span>",
      "id": "914440",
      "machine_only": false,
      "num_replies": 1,
      "num_reposts": 3,
      "num_stars": 3,
      "source": {
        "client_id": "caYWDBvjwt2e9HWMm6qyKS6KcATHUkzQ",
        "link": "https://alpha.app.net",
        "name": "Alpha"
      },
      "text": "If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first #adnhack => http://appnet.eventbrite.com/",
      "thread_id": "914440",
      "user": "...user object...",
      "you_reposted": false,
      "you_starred": false,
      "pagination_id": "914440"
    }
  ],
  "meta": {
    "code": 200,
    "more": false,
    "min_id": "914440",
    "max_id": "914440"
  }
}

Retrieve a User’s personalized stream

Return the 20 most recent Posts from the current User and the Users they follow.

This endpoint responds to general Post parameters.

This endpoint can be Faceted to filter it’s results.

Responses from this endpoint are paginated.

Endpoint

Method	URL	Token	Scope
GET	https://alpha-api.app.net/stream/0/posts/stream	User	stream

Example

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/posts/stream"

{
  "data": [
    {
      "canonical_url": "https://alpha.app.net/adn/post/914440",
      "created_at": "2012-10-11T19:48:40Z",
      "entities": {
        "hashtags": [
          {
            "len": 8,
            "name": "adnhack",
            "pos": 90
          }
        ],
        "links": [
          {
            "len": 29,
            "pos": 100,
            "text": "http://appnet.eventbrite.com/",
            "url": "http://appnet.eventbrite.com/"
          }
        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first <span data-hashtag-name=\"adnhack\" itemprop=\"hashtag\">#adnhack</span> => <a href=\"http://appnet.eventbrite.com/\">http://appnet.eventbrite.com/</a></span>",
      "id": "914440",
      "machine_only": false,
      "num_replies": 1,
      "num_reposts": 3,
      "num_stars": 3,
      "source": {
        "client_id": "caYWDBvjwt2e9HWMm6qyKS6KcATHUkzQ",
        "link": "https://alpha.app.net",
        "name": "Alpha"
      },
      "text": "If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first #adnhack => http://appnet.eventbrite.com/",
      "thread_id": "914440",
      "user": "...user object...",
      "you_reposted": false,
      "you_starred": false,
      "pagination_id": "914440"
    }
  ],
  "meta": {
    "code": 200,
    "more": false,
    "min_id": "914440",
    "max_id": "914440"
  }
}

Retrieve a User’s unified stream

Return the 20 most recent Posts from the current user’s personalized stream and mentions stream merged into one stream.

This endpoint responds to general Post parameters.

Responses from this endpoint are paginated.

This endpoint can be Faceted to filter it’s results.

Endpoint

Method	URL	Token	Scope
GET	https://alpha-api.app.net/stream/0/posts/stream/unified	User	stream

Example

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/posts/stream/unified"

{
  "data": [
    {
      "canonical_url": "https://alpha.app.net/adn/post/914440",
      "created_at": "2012-10-11T19:48:40Z",
      "entities": {
        "hashtags": [
          {
            "len": 8,
            "name": "adnhack",
            "pos": 90
          }
        ],
        "links": [
          {
            "len": 29,
            "pos": 100,
            "text": "http://appnet.eventbrite.com/",
            "url": "http://appnet.eventbrite.com/"
          }
        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first <span data-hashtag-name=\"adnhack\" itemprop=\"hashtag\">#adnhack</span> => <a href=\"http://appnet.eventbrite.com/\">http://appnet.eventbrite.com/</a></span>",
      "id": "914440",
      "machine_only": false,
      "num_replies": 1,
      "num_reposts": 3,
      "num_stars": 3,
      "source": {
        "client_id": "caYWDBvjwt2e9HWMm6qyKS6KcATHUkzQ",
        "link": "https://alpha.app.net",
        "name": "Alpha"
      },
      "text": "If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first #adnhack => http://appnet.eventbrite.com/",
      "thread_id": "914440",
      "user": "...user object...",
      "you_reposted": false,
      "you_starred": false,
      "pagination_id": "914440"
    }
  ],
  "meta": {
    "code": 200,
    "more": false,
    "min_id": "914440",
    "max_id": "914440"
  }
}

Retrieve tagged Posts

Return the 20 most recent Posts for a specific hashtag.

This endpoint responds to general Post parameters.

Responses from this endpoint are paginated.

Endpoint

Method	URL	Token
GET	https://alpha-api.app.net/stream/0/posts/tag/{hashtag}	None

Example

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/posts/tag/adnhack"

{
  "data": [
    {
      "canonical_url": "https://alpha.app.net/adn/post/914440",
      "created_at": "2012-10-11T19:48:40Z",
      "entities": {
        "hashtags": [
          {
            "len": 8,
            "name": "adnhack",
            "pos": 90
          }
        ],
        "links": [
          {
            "len": 29,
            "pos": 100,
            "text": "http://appnet.eventbrite.com/",
            "url": "http://appnet.eventbrite.com/"
          }
        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first <span data-hashtag-name=\"adnhack\" itemprop=\"hashtag\">#adnhack</span> => <a href=\"http://appnet.eventbrite.com/\">http://appnet.eventbrite.com/</a></span>",
      "id": "914440",
      "machine_only": false,
      "num_replies": 1,
      "num_reposts": 3,
      "num_stars": 3,
      "source": {
        "client_id": "caYWDBvjwt2e9HWMm6qyKS6KcATHUkzQ",
        "link": "https://alpha.app.net",
        "name": "Alpha"
      },
      "text": "If you're in San Francisco on Saturday October 20 and Sunday October 21 come to the first #adnhack => http://appnet.eventbrite.com/",
      "thread_id": "914440",
      "user": "...user object...",
      "you_reposted": false,
      "you_starred": false,
      "pagination_id": "914440"
    }
  ],
  "meta": {
    "code": 200,
    "more": false,
    "min_id": "914440",
    "max_id": "914440"
  }
}