.--.
`. \
\ \
. \
: .
| .
| :
| |
..._ ___ | |
`."".`''''""--..___ | |
,-\ \ ""-...__ _____________/ |
/ ` " ' `"""""""" .
\ L
(> \
/ \
\_ ___..---. L
`--' '. \
. \_
_/`. `.._
.' -. `.
/ __.-Y /''''''-...___,...--------.._ |
/ _." | / ' . \ '---..._ |
/ / / / _,. ' ,/ | |
\_,' _.' / /'' _,-' _| |
' / `-----'' / |
`...-' dp `...-'
via chris.com
#BuzzFeed API
The following 3 endpoints are public. That means: no need for authentication !!
Also if you'd like to access our API from the frontend, all the enpoints support JSONP. Simply append ?jsonp=xyz
to the endpoint URL.
##Feeds Get JSON representation of any feed page on buzzfeed.com, i.e. /news, /lol, /bensmith, /life
Examples:
- http://www.buzzfeed.com/api/v2/feeds/lol
- http://www.buzzfeed.com/api/v2/feeds/index
- http://www.buzzfeed.com/api/v2/feeds/omg?p=2
- http://www.buzzfeed.com/api/v2/feeds/news
- http://www.buzzfeed.com/api/v2/feeds/bensmith?p=3&jsonp=myCallback
NOTE: Disregard ad_backfill
. flow
is what contains the actual feed content.
##Articles
Get a JSON representation of a BuzzFeed article. For that you'll need to know the buzz_id
of the article, which you can easily find in the object returned by the Feeds API.
Examples:
- http://www.buzzfeed.com/api/v2/buzz/4032262
- http://www.buzzfeed.com/api/v2/buzz/4025724
- http://www.buzzfeed.com/api/v2/buzz/4025724?jsonp=myCallback
NOTE: The body of each article is composed of an array of ordered sub_buzzes
. Each sub_buzz has a specific type (see form
field). Here are some examples of sub_buzz types text
, image
, image_group
, quiz
, tweet
, etc.
##Comments
Get a JSON representation of the comments section of a specific article. Like the Articles endpoint, you'll need a buzz_id
.
Examples:
- http://www.buzzfeed.com/api/v2/comments/3243142
- http://www.buzzfeed.com/api/v2/comments/3243142?p=2
- http://www.buzzfeed.com/api/v2/comments/4019778?jsonp=myCallback
NOTE: Not all BuzzFeed articles have comments! For example, news articles do not.
Enjoy!
The BuzzFeed Tech Team