List Containers
Fetches a list of containers from Digg. For each container, the short_name attribute may be used in a List Stories request, e.g. /stories/container/{container name}.
Example Request
Retrieve all Digg containers:
http://services.digg.com/containers?appkey=http%3A%2F%2Fapidoc.digg.com
Example Responses
XML
<?xml version="1.0" encoding="utf-8" ?> <containers timestamp="1196889156"> <container name="Technology" short_name="technology"> <topic name="Apple" short_name="apple" /> <topic name="Design" short_name="design" /> <topic name="Gadgets" short_name="gadgets" /> <topic name="Hardware" short_name="hardware" /> <topic name="Tech Industry News" short_name="tech_news" /> <topic name="Linux/Unix" short_name="linux_unix" /> <topic name="Microsoft" short_name="microsoft" /> <topic name="Mods" short_name="mods" /> <topic name="Programming" short_name="programming" /> <topic name="Security" short_name="security" /> <topic name="Software" short_name="software" /> </container> <container name="World & Business" short_name="world_business"> <topic name="Business & Finance" short_name="business_finance" /> <topic name="World News" short_name="world_news" /> <topic name="Political News" short_name="politics" /> <topic name="Political Opinion" short_name="political_opinion" /> <topic name="US Elections 2008" short_name="2008_us_elections" /> </container> <container name="Science" short_name="science"> <topic name="Environment" short_name="environment" /> <topic name="General Sciences" short_name="general_sciences" /> <topic name="Space" short_name="space" /> </container> <container name="Gaming" short_name="gaming"> <topic name="Gaming Industry News" short_name="gaming_news" /> <topic name="PC Games" short_name="pc_games" /> <topic name="Playable Web Games" short_name="playable_web_games" /> <topic name="Nintendo" short_name="nintendo" /> <topic name="PlayStation" short_name="playstation" /> <topic name="Xbox" short_name="xbox" /> </container> <container name="Lifestyle" short_name="lifestyle"> <topic name="Arts & Culture" short_name="arts_culture" /> <topic name="Autos" short_name="autos" /> <topic name="Educational" short_name="educational" /> <topic name="Food & Drink" short_name="food_drink" /> <topic name="Health" short_name="health" /> <topic name="Travel & Places" short_name="travel_places" /> </container> <container name="Entertainment" short_name="entertainment"> <topic name="Celebrity" short_name="celebrity" /> <topic name="Movies" short_name="movies" /> <topic name="Music" short_name="music" /> <topic name="Television" short_name="television" /> <topic name="Comics & Animation" short_name="comics_animation" /> </container> <container name="Sports" short_name="sports"> <topic name="Baseball" short_name="baseball" /> <topic name="Basketball" short_name="basketball" /> <topic name="Extreme" short_name="extreme_sports" /> <topic name="American & Canadian Football" short_name="football" /> <topic name="Golf" short_name="golf" /> <topic name="Hockey" short_name="hockey" /> <topic name="Motorsport" short_name="motorsport" /> <topic name="Soccer" short_name="soccer" /> <topic name="Tennis" short_name="tennis" /> <topic name="Other Sports" short_name="other_sports" /> </container> <container name="Offbeat" short_name="offbeat"> <topic name="Comedy" short_name="comedy" /> <topic name="Odd Stuff" short_name="odd_stuff" /> <topic name="People" short_name="people" /> <topic name="Pets & Animals" short_name="pets_animals" /> </container> </containers>
JSON
{
"timestamp" : 1196889192,
"containers" : [
{
"name" : "Technology",
"short_name" : "technology",
"topics" : [
{
"name" : "Apple",
"short_name" : "apple"
},
{
"name" : "Design",
"short_name" : "design"
},
{
"name" : "Gadgets",
"short_name" : "gadgets"
},
{
"name" : "Hardware",
"short_name" : "hardware"
},
{
"name" : "Tech Industry News",
"short_name" : "tech_news"
},
{
"name" : "Linux/Unix",
"short_name" : "linux_unix"
},
{
"name" : "Microsoft",
"short_name" : "microsoft"
},
{
"name" : "Mods",
"short_name" : "mods"
},
{
"name" : "Programming",
"short_name" : "programming"
},
{
"name" : "Security",
"short_name" : "security"
},
{
"name" : "Software",
"short_name" : "software"
}
]
},
{
"name" : "World & Business",
"short_name" : "world_business",
"topics" : [
{
"name" : "Business & Finance",
"short_name" : "business_finance"
},
{
"name" : "World News",
"short_name" : "world_news"
},
{
"name" : "Political News",
"short_name" : "politics"
},
{
"name" : "Political Opinion",
"short_name" : "political_opinion"
},
{
"name" : "US Elections 2008",
"short_name" : "2008_us_elections"
}
]
},
{
"name" : "Science",
"short_name" : "science",
"topics" : [
{
"name" : "Environment",
"short_name" : "environment"
},
{
"name" : "General Sciences",
"short_name" : "general_sciences"
},
{
"name" : "Space",
"short_name" : "space"
}
]
},
{
"name" : "Gaming",
"short_name" : "gaming",
"topics" : [
{
"name" : "Gaming Industry News",
"short_name" : "gaming_news"
},
{
"name" : "PC Games",
"short_name" : "pc_games"
},
{
"name" : "Playable Web Games",
"short_name" : "playable_web_games"
},
{
"name" : "Nintendo",
"short_name" : "nintendo"
},
{
"name" : "PlayStation",
"short_name" : "playstation"
},
{
"name" : "Xbox",
"short_name" : "xbox"
}
]
},
{
"name" : "Lifestyle",
"short_name" : "lifestyle",
"topics" : [
{
"name" : "Arts & Culture",
"short_name" : "arts_culture"
},
{
"name" : "Autos",
"short_name" : "autos"
},
{
"name" : "Educational",
"short_name" : "educational"
},
{
"name" : "Food & Drink",
"short_name" : "food_drink"
},
{
"name" : "Health",
"short_name" : "health"
},
{
"name" : "Travel & Places",
"short_name" : "travel_places"
}
]
},
{
"name" : "Entertainment",
"short_name" : "entertainment",
"topics" : [
{
"name" : "Celebrity",
"short_name" : "celebrity"
},
{
"name" : "Movies",
"short_name" : "movies"
},
{
"name" : "Music",
"short_name" : "music"
},
{
"name" : "Television",
"short_name" : "television"
},
{
"name" : "Comics & Animation",
"short_name" : "comics_animation"
}
]
},
{
"name" : "Sports",
"short_name" : "sports",
"topics" : [
{
"name" : "Baseball",
"short_name" : "baseball"
},
{
"name" : "Basketball",
"short_name" : "basketball"
},
{
"name" : "Extreme",
"short_name" : "extreme_sports"
},
{
"name" : "American & Canadian Football",
"short_name" : "football"
},
{
"name" : "Golf",
"short_name" : "golf"
},
{
"name" : "Hockey",
"short_name" : "hockey"
},
{
"name" : "Motorsport",
"short_name" : "motorsport"
},
{
"name" : "Soccer",
"short_name" : "soccer"
},
{
"name" : "Tennis",
"short_name" : "tennis"
},
{
"name" : "Other Sports",
"short_name" : "other_sports"
}
]
},
{
"name" : "Offbeat",
"short_name" : "offbeat",
"topics" : [
{
"name" : "Comedy",
"short_name" : "comedy"
},
{
"name" : "Odd Stuff",
"short_name" : "odd_stuff"
},
{
"name" : "People",
"short_name" : "people"
},
{
"name" : "Pets & Animals",
"short_name" : "pets_animals"
}
]
}
]
}
PHP
O:17:"DiggAPIContainers":2:{s:9:"timestamp";i:1196893282;s:10:"containers";a:8:{i:0;O:16:"DiggAPIContainer":3:{s:4:"name";s:10:"Technology";s:10:"short_name";s:10:"technology";s:6:"topics";a:11:{i:0;O:12:"DiggAPITopic":2:{s:4:"name";s:5:"Apple";s:10:"short_name";s:5:"apple";}i:1;O:12:"DiggAPITopic":2:{s:4:"name";s:6:"Design";s:10:"short_name";s:6:"design";}i:2;O:12:"DiggAPITopic":2:{s:4:"name";s:7:"Gadgets";s:10:"short_name";s:7:"gadgets";}i:3;O:12:"DiggAPITopic":2:{s:4:"name";s:8:"Hardware";s:10:"short_name";s:8:"hardware";}i:4;O:12:"DiggAPITopic":2:{s:4:"name";s:18:"Tech Industry News";s:10:"short_name";s:9:"tech_news";}i:5;O:12:"DiggAPITopic":2:{s:4:"name";s:10:"Linux/Unix";s:10:"short_name";s:10:"linux_unix";}i:6;O:12:"DiggAPITopic":2:{s:4:"name";s:9:"Microsoft";s:10:"short_name";s:9:"microsoft";}i:7;O:12:"DiggAPITopic":2:{s:4:"name";s:4:"Mods";s:10:"short_name";s:4:"mods";}i:8;O:12:"DiggAPITopic":2:{s:4:"name";s:11:"Programming";s:10:"short_name";s:11:"programming";}i:9;O:12:"DiggAPITopic":2:{s:4:"name";s:8:"Security";s:10:"short_name";s:8:"security";}i:10;O:12:"DiggAPITopic":2:{s:4:"name";s:8:"Software";s:10:"short_name";s:8:"software";}}}i:1;O:16:"DiggAPIContainer":3:{s:4:"name";s:16:"World & Business";s:10:"short_name";s:14:"world_business";s:6:"topics";a:5:{i:0;O:12:"DiggAPITopic":2:{s:4:"name";s:18:"Business & Finance";s:10:"short_name";s:16:"business_finance";}i:1;O:12:"DiggAPITopic":2:{s:4:"name";s:10:"World News";s:10:"short_name";s:10:"world_news";}i:2;O:12:"DiggAPITopic":2:{s:4:"name";s:14:"Political News";s:10:"short_name";s:8:"politics";}i:3;O:12:"DiggAPITopic":2:{s:4:"name";s:17:"Political Opinion";s:10:"short_name";s:17:"political_opinion";}i:4;O:12:"DiggAPITopic":2:{s:4:"name";s:17:"US Elections 2008";s:10:"short_name";s:17:"2008_us_elections";}}}i:2;O:16:"DiggAPIContainer":3:{s:4:"name";s:7:"Science";s:10:"short_name";s:7:"science";s:6:"topics";a:3:{i:0;O:12:"DiggAPITopic":2:{s:4:"name";s:11:"Environment";s:10:"short_name";s:11:"environment";}i:1;O:12:"DiggAPITopic":2:{s:4:"name";s:16:"General Sciences";s:10:"short_name";s:16:"general_sciences";}i:2;O:12:"DiggAPITopic":2:{s:4:"name";s:5:"Space";s:10:"short_name";s:5:"space";}}}i:3;O:16:"DiggAPIContainer":3:{s:4:"name";s:6:"Gaming";s:10:"short_name";s:6:"gaming";s:6:"topics";a:6:{i:0;O:12:"DiggAPITopic":2:{s:4:"name";s:20:"Gaming Industry News";s:10:"short_name";s:11:"gaming_news";}i:1;O:12:"DiggAPITopic":2:{s:4:"name";s:8:"PC Games";s:10:"short_name";s:8:"pc_games";}i:2;O:12:"DiggAPITopic":2:{s:4:"name";s:18:"Playable Web Games";s:10:"short_name";s:18:"playable_web_games";}i:3;O:12:"DiggAPITopic":2:{s:4:"name";s:8:"Nintendo";s:10:"short_name";s:8:"nintendo";}i:4;O:12:"DiggAPITopic":2:{s:4:"name";s:11:"PlayStation";s:10:"short_name";s:11:"playstation";}i:5;O:12:"DiggAPITopic":2:{s:4:"name";s:4:"Xbox";s:10:"short_name";s:4:"xbox";}}}i:4;O:16:"DiggAPIContainer":3:{s:4:"name";s:9:"Lifestyle";s:10:"short_name";s:9:"lifestyle";s:6:"topics";a:6:{i:0;O:12:"DiggAPITopic":2:{s:4:"name";s:14:"Arts & Culture";s:10:"short_name";s:12:"arts_culture";}i:1;O:12:"DiggAPITopic":2:{s:4:"name";s:5:"Autos";s:10:"short_name";s:5:"autos";}i:2;O:12:"DiggAPITopic":2:{s:4:"name";s:11:"Educational";s:10:"short_name";s:11:"educational";}i:3;O:12:"DiggAPITopic":2:{s:4:"name";s:12:"Food & Drink";s:10:"short_name";s:10:"food_drink";}i:4;O:12:"DiggAPITopic":2:{s:4:"name";s:6:"Health";s:10:"short_name";s:6:"health";}i:5;O:12:"DiggAPITopic":2:{s:4:"name";s:15:"Travel & Places";s:10:"short_name";s:13:"travel_places";}}}i:5;O:16:"DiggAPIContainer":3:{s:4:"name";s:13:"Entertainment";s:10:"short_name";s:13:"entertainment";s:6:"topics";a:5:{i:0;O:12:"DiggAPITopic":2:{s:4:"name";s:9:"Celebrity";s:10:"short_name";s:9:"celebrity";}i:1;O:12:"DiggAPITopic":2:{s:4:"name";s:6:"Movies";s:10:"short_name";s:6:"movies";}i:2;O:12:"DiggAPITopic":2:{s:4:"name";s:5:"Music";s:10:"short_name";s:5:"music";}i:3;O:12:"DiggAPITopic":2:{s:4:"name";s:10:"Television";s:10:"short_name";s:10:"television";}i:4;O:12:"DiggAPITopic":2:{s:4:"name";s:18:"Comics & Animation";s:10:"short_name";s:16:"comics_animation";}}}i:6;O:16:"DiggAPIContainer":3:{s:4:"name";s:6:"Sports";s:10:"short_name";s:6:"sports";s:6:"topics";a:10:{i:0;O:12:"DiggAPITopic":2:{s:4:"name";s:8:"Baseball";s:10:"short_name";s:8:"baseball";}i:1;O:12:"DiggAPITopic":2:{s:4:"name";s:10:"Basketball";s:10:"short_name";s:10:"basketball";}i:2;O:12:"DiggAPITopic":2:{s:4:"name";s:7:"Extreme";s:10:"short_name";s:14:"extreme_sports";}i:3;O:12:"DiggAPITopic":2:{s:4:"name";s:28:"American & Canadian Football";s:10:"short_name";s:8:"football";}i:4;O:12:"DiggAPITopic":2:{s:4:"name";s:4:"Golf";s:10:"short_name";s:4:"golf";}i:5;O:12:"DiggAPITopic":2:{s:4:"name";s:6:"Hockey";s:10:"short_name";s:6:"hockey";}i:6;O:12:"DiggAPITopic":2:{s:4:"name";s:10:"Motorsport";s:10:"short_name";s:10:"motorsport";}i:7;O:12:"DiggAPITopic":2:{s:4:"name";s:6:"Soccer";s:10:"short_name";s:6:"soccer";}i:8;O:12:"DiggAPITopic":2:{s:4:"name";s:6:"Tennis";s:10:"short_name";s:6:"tennis";}i:9;O:12:"DiggAPITopic":2:{s:4:"name";s:12:"Other Sports";s:10:"short_name";s:12:"other_sports";}}}i:7;O:16:"DiggAPIContainer":3:{s:4:"name";s:7:"Offbeat";s:10:"short_name";s:7:"offbeat";s:6:"topics";a:4:{i:0;O:12:"DiggAPITopic":2:{s:4:"name";s:6:"Comedy";s:10:"short_name";s:6:"comedy";}i:1;O:12:"DiggAPITopic":2:{s:4:"name";s:9:"Odd Stuff";s:10:"short_name";s:9:"odd_stuff";}i:2;O:12:"DiggAPITopic":2:{s:4:"name";s:6:"People";s:10:"short_name";s:6:"people";}i:3;O:12:"DiggAPITopic":2:{s:4:"name";s:14:"Pets & Animals";s:10:"short_name";s:12:"pets_animals";}}}}}
Endpoint
- GET /containers
- Get a list of all containers.
- GET /container/{container short_name}
- Get a specified container.
Arguments
See ResponseTypes and ApplicationKeys.
Page Information
|
Wiki Information |
Recent PBwiki Blog Posts |
Create your own business wiki!