Stars

Star a Post

Save a given Post to the current User’s stars. This is just a “save” action, not a sharing action. A User’s stars are visible to others, but they are not automatically added to your followers’ streams.

A repost cannot be starred. Please star the parent Post.

This endpoint responds to general Post parameters.

Endpoint

Method URL Token Scope
POST https://api.app.net/posts/{post_id}/star User write_post

URL Parameters

Name Description
post_id The id of the Post to star.

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/posts/914440/star"
{
  "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": 4,
    "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": true
  },
  "meta": {
    "code": 200
  }
}

Unstar a Post

Remove a Star from a Post.

This endpoint responds to general Post parameters.

Endpoint

Method URL Token Scope
DELETE https://api.app.net/posts/{post_id}/star User write_post

URL Parameters

Name Description
post_id The id of the Post to unstar.

Example

to see more complete examples.

curl -X DELETE -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/posts/914440/star"
{
  "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
  },
  "meta": {
    "code": 200
  }
}

Retrieve Posts starred by a User

Get the most recent Posts starred by a specific User in reverse post order. Stars are a way for Users to save posts without rebroadcasting the Post to their followers.

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}/stars 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.

See General Parameters for optional parameters you can use with this query.

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/stars"
{
  "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": 4,
      "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": true,
      "pagination_id": "914440"
    }
  ],
  "meta": {
    "code": 200,
    "more": false,
    "min_id": "914440",
    "max_id": "914440"
  }
}