Post Streams

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://api.app.net/posts/stream/global None

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/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://api.app.net/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

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/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://api.app.net/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

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/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://api.app.net/posts/stream User stream

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/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://api.app.net/posts/stream/unified User stream

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/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://api.app.net/posts/tag/{hashtag} None

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/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"
  }
}