Forum Discussion

Lithium Alumni (Retired)

11 years ago

API for contests?

Are there specific APIs for retrieving contest content like being able to pull most popular, most recent content entries etc? Thank you!

DougS
11 years ago
Contests are a "style" of board: "forum", "blog", "idea", "contest", "qanda", "review", etc. are all board "Conversation Styles" (we used to call this "Interaction Styles" or "Discussion Styles"). We have API calls to select messages or threads for a given board by the board's ID:

Topics in a board, sorted by most recent first: http://community.lithium.com/t5/Community-API/bd-p/developers-rest-api?leaf-id=Board.topics#Board.topics.recent

Replies in a board, sorted by most recent first: http://community.lithium.com/t5/Community-API/bd-p/developers-rest-api?leaf-id=Board.replies#Board.replies.recent

Posts (topics + replies) in a board, sorted by most recent first: http://community.lithium.com/t5/Community-API/bd-p/developers-rest-api?leaf-id=Board.posts#Board.replies.posts

"popular" is a concept that only applies to threads -- here is the call to get popular threads:

http://community.lithium.com/t5/Community-API/bd-p/developers-rest-api?leaf-id=Board.threads#Board.threads.popular

Possibly related: If you need to find the list of all "contest" boards in the community:

http://community.lithium.com/restapi/vc/boards/style/contest/nested

Khoros Alumni (Retired)

How would you retrieve the contest winner via API? Is that a "featured" contest entry?

I'm trying to get an idea of a widget that shows recent contests and their winners, and I'm wondering how to structure that call.

Khoros Oracle

11 years ago

Since the winners are the ones with the most kudos, you'd want to look at the top-messages leadboard for that contest board -- take a look at this call: http://community.lithium.com/t5/Community-API/bd-p/developers-rest-api?leaf-id=Board.kudos.leaderboard.top-messages#Board.kudos.leaderboard.top-messages