Urls | API v1 Documentation

"id" long - optional, defaults to the current user "curated" int - optional, default to 0, number of curated posts to retrieve for each topic present in user data "curable" int - optional, default to 0, number of curable posts to retrieve for each topic the current user is the curator (so it should not be specified if the "id" parameter is specified) "ncomments" int - optional, default to 0, the maximum number of comments to retrieve for each curated post found in each topic present in user data "getCuratedTopics" bool - optional, default to true. returns or not list of curated topics "getFollowedTopics" bool - optional, default to true. returns or not list of followed topics "getTags" bool - optional, default to true. returns or not list of tags for each returned topic "getCreator" bool - optional, default to true. returns or not creator of each returned topic "getStats" bool - optional, default to true. returns or not stats for each returned topic

{ "user" : < user > - the user "stats" : < "v" : int - number of views on the user's content "vp" : int - number of views progression on the user's content "uv" : int - DEPRECATED - number of unique visitors on the user's content "uvp" : int - DEPRECATED - number of unique visitors progression on the user's content > }

"id" long - the id of the topic "curated" int - optional, default to 30, number of curated posts to retrieve for this topic "page" int - optional, default to 0, page number of curated post to retrieve "curable" int - optional, default to 0, number of curable posts to retrieve for this topic, this parameter is ignored if the current user is not the curator of this topic "order" string - mandatory if "since" parameter is not specified: sort order of the curated posts, can be "tag" (see below), "curationDate", "user" (same order as seen in the scoop.it website) "tag" string - mandatory if "order"=="tag", specify the tag used to filter results "since" timestamp - only retrieve curated post newer than this timestamp "ncomments": int - optional, default to 100, the maximum number of comments to retrieve for each curated post found in this topic

{ "topic" : < topic > - the topic }

"edit": - edit a topic "reorder": - reorder curated posts "follow": - follow this topic "unfollow": - unfollow this topic "markread": - mark this topic as read (reset the "unreadPostCount" field)

"action": string - "edit", "id": long - the topic id, "name": string - optional, the new name of the topic "description" string - optional, the new description of the topic (can be an empty string) "lang" string - optional, the new language of the topic (the iso 639 code), for chinese (simplified/traditionnal), specify the full Locale (eg: zh_CN or zh_TW)

{ "topic" : < topic > - the topic }

"action": string - "reorder", "id": long - the topic id, "postId": long[] - multiple request parameter of posts belonging to this topic in the new order it must appear in the website (aka the "user" order), "start": int - optional, default to 0, the start index of reorder destination.

{ }

"action": string - "follow", "unfollow" or "markread", "id": long - the topic id,

{ }

"id": long - id of the post "ncomments": int - optional, default to 100, the maximum number of comments to retrieve for this post

{ "post": < post > - the post. }

"prepare": - prepare a new post (retrieve data from an url), "create": - create a new post, "comment": - comment a post, "thank": - thank a post, "accept": - accept a post (aka curate the post, aka publish the post), "forward": - forward a post to another topic (do a suggestion to another user), "refuse": - refuse a post, "delete": - delete a post, "edit": - edit a post, "pin": - pin a post to its topic. "rescoop": - re-scoop a post from a topic to another one. "share": - share a post (on twitter, facebook...)

"action": string - "prepare", "url": string - the url of the post

{ "post": < post >* - the prepared post: it contains only a limited amount of data }

"action": string - "create", "title": string - title of the post, "url": string - the url of the post, "content": string - the content of the post, "insight": string - optional, the insight of the curator "imageUrl": string - the picture url of the post, "topicId": long - the destination topic id, "shareOn": json - if the current user is belong to topic's curators, an array of objects representing sharers to publish the post on. eg: [{"sharerId": "twitter", "cnxId": 12, "text": "The Tweet #foo #bar http://sco.lt/..."}, {"sharerId": "facebook", "cnxId": 26, "text": "The Facebook Text"}]

{ "post": < post > - the post. }

"action": string - "comment", "id": long - post id, "commentText": string - the comment.

{ }

"action": string - "thank", "id": long - post id

{ "thankCount": int - the number of thanks for this post "thanked": boolean - true if the action post has not yet been thanked by the current user }

"action": string - "accept", "id": long - post id, "title": string - optional, new of the post, "content": string - optional, new content of the post, "insight": string - optional, the insight of the curator "imageUrl": string - picture url of the post, "shareOn": json - optional, an array of objects representing sharers to publish the post on. eg: [{"sharerId": "twitter", "cnxId": 12, "text"*: "Tweet text #foo #bar http://sco.lt/..."}, {"sharerId": "twitter", "cnxId": 26, "text"*:"Other Tweet Text #foo #bar http://sco.lt/..."}] "topicId": long - optional, if specified, the post will be published to this topic

{ "post": < post > - the post, "curablePostCount" long - the number of curable post count of the post topic. }

"action": string - "forward", "id": long - post id, "title": string - optional, new of the post, "content": string - optional, new content of the post, "insight": string - optional, the insight of the curator "imageUrl": string - picture url of the post, "shareOn": json - optional, an array of objects representing sharers to publish the post on. eg: [{"sharerId": "twitter", "cnxId": 12, "text"*: "Tweet text #foo #bar http://sco.lt/..."}, {"sharerId": "twitter", "cnxId": 26, "text"*:"Other Tweet Text #foo #bar http://sco.lt/..."}] "topicId": long - the id the topic to forward the post to.

{ "post": < post > - the post. }

"action": string - "refuse", "id": long - post id, "reason": string - optional, for an user suggestion, the reason why this post has been refused: it will be included in the notification email.

{ "curablePostCount" long - the number of curable post count of the refust post topic. }

"action": string - "delete", "id": long - post id,

{ }

"action": string - "edit", "id": long - post id, "tag": string[] - optional, list of tags to apply to the post. To remove all, specify only one empty "tag" parameter, "title": string - optional, new title of the post, "content": string - optional, new content of the post, "insight": string - optional, the insight of the curator "imageUrl": string - optional, new picture of the post.

{ "post": < post > - the post. }

"action": string - "pin", "id": long - post id,

{ }

"action": string - "rescoop", "id": long - id of the post to be re-scooped, "destTopicId": long - id of the destination topic. "tag": string[] - optional, list of tags to apply to the post. To remove all, specify only one empty "tag" parameter, "title": string - optional, new title of the post, "content": string - optional, new content of the post, "insight": string - optional, the insight of the curator "imageUrl": string - optional, new picture of the post.

{ "post": < post > - the post on the destination topic. }

"id": long - post id, "shareOn": json - an array of objects representing sharers to publish the post on. eg: [{"sharerId": "twitter", "cnxId": 12, "text"*: "Tweet text #foo #bar http://sco.lt/..."}, {"sharerId": "twitter", "cnxId": 26, "text"*:"Other Tweet Text #foo #bar http://sco.lt/..."}]

{ }

{ connectedUser: < user - the current connected user, or null in anonymous mode. }

"since": timestamp - only new notification from this timestamp will be returned.

{ "notifications": < notification[] > }

"sort": string - optional, method used for sorting posts, can be "rss" (by default), post are ordered like in the RSS feed of the users followed topics, or "following", posts are ordered like in the Explore page, "since": timestamp - no posts older than this timestamp will be returned "count": int - maximum number of posts to return "page" int - optional, default to 0, page number of posts to retrieve "ncomments" int - optional, default to 100, the maximum number of comments to retrieve for each returned post "getTags" bool - optional, default to true. returns or not list of tags for each returned post. "getTagsForTopic" bool - optional, default to true. returns or not tags for topic of each returned post "getStatsForTopic" bool - optional, default to true. returns or not stats for topic of each returned post

{ "posts": < post[] > }

"type" string - type of object searched: "user", "topic" or "post" "query" string - the search query "count" int - the number of item per page. If not present, defaults to 50 "page" int - optional, the page number to return, the first page is 0. If not present, defaults to 0. "lang" string - optional, the language of the content to search into. (defaults to "en") "topicId" long - optional, the id of the topic to search posts into "getTags" bool - optional, default to true. returns or not list of tags for each returned topic / post. only for type="topic" or type="post" "getCreator" bool - optional, default to true. returns or not creator of each returned topic. only for type="topic" "getStats" bool - optional, default to true. returns or not stats for each returned topic. only for type="topic" "getTagsForTopic" bool - optional, default to true. returns or not tags for topic of each returned post. only for type="post" "getStatsForTopic" bool - optional, default to true. returns or not stats for topic of each returned post. only for type="post"

{ "totalFound": int - the total number of results found. "users": < user[] > - users found (if applicable) "topics": < topic[] > - topics found (if applicable) "posts": < post[] > - posts found (if applicable) }

"type": string - "User" or "Topic", "shortName": string - a short name

{ "type": string - the requested type value, "id": long - id of the found resource }