Welcome a new enhancement to the Top Stories feature in our SERP API: Badges!
Badges provide additional context to the results. They appear as labels that indicate specific types of content featured in Top Stories, such as “Video,” “Live,” or “Interview.”
In DataForSEO SERP API responses, badges are provided as an array containing relevant type(s) of content for the result.
{
"type": "top_stories",
"rank_group": 2,
"rank_absolute": 3,
"position": "left",
"xpath": "/html[1]/body[1]/div[3]/div[1]/div[13]/div[3]/div[1]/div[2]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[1]/div[3]/div[3]/div[1]/div[1]/div[2]/g-section-with-header[1]",
"title": null,
"items": [
{
"type": "top_stories_element",
"source": "NBC News",
"domain": "www.nbcnews.com",
"title": "2024 Olympics live updates: U.S. women, men in relays, breaking begins",
"date": "20 minutes ago",
"amp_version": false,
"timestamp": "2024-08-09 09:11:42 +00:00",
"url": "https://www.nbcnews.com/sports/olympics/live-blog/olympic-games-2024-live-updates-rcna162874",
"image_url": "https://api.dataforseo.com/cdn/i/08091231-1535-0139-0000-df98406ade32:7",
"badges": [
"live"
]
},
{
"type": "top_stories_element",
"source": "ESPN",
"domain": "www.espn.com",
"title": "Team USA storms back for win against Serbia and more from Paris",
"date": "12 hours ago",
"amp_version": false,
"timestamp": "2024-08-08 21:31:42 +00:00",
"url": "https://www.espn.com/olympics/story/_/id/40769716/2024-paris-summer-olympics-live-updates-highlights-schedule-results-thursday",
"image_url": "https://api.dataforseo.com/cdn/i/08091231-1535-0139-0000-df98406ade32:8",
"badges": null
},
{
"type": "top_stories_element",
"source": "BBC",
"domain": "www.bbc.com",
"title": "Paris 2024 Olympics: Letsile Tebogo claims 200m gold as Noah Lyles takes \nbronze",
"date": "15 hours ago",
"amp_version": false,
"timestamp": "2024-08-08 18:31:42 +00:00",
"url": "https://www.bbc.com/sport/olympics/articles/cp81x1k1yjno",
"image_url": "https://api.dataforseo.com/cdn/i/08091231-1535-0139-0000-df98406ade32:9",
"badges": null
},
{
"type": "top_stories_element",
"source": "NPR",
"domain": "www.npr.org",
"title": "The U.S. men's basketball team wins a nail-biter over Serbia to play for \nOlympic gold",
"date": "11 hours ago",
"amp_version": false,
"timestamp": "2024-08-08 22:31:42 +00:00",
"url": "https://www.npr.org/2024/08/08/g-s1-16050/usa-mens-basketball-serbia-paris-olympics",
"image_url": "https://api.dataforseo.com/cdn/i/08091231-1535-0139-0000-df98406ade32:10",
"badges": null
},
{
"type": "top_stories_element",
"source": "Yahoo Sports",
"domain": "sports.yahoo.com",
"title": "USA vs. Serbia score, live updates: Nikola Jokić clashes with LeBron and \nCo. in marquee Paris Olympics semifinal",
"date": "13 hours ago",
"amp_version": false,
"timestamp": "2024-08-08 20:31:42 +00:00",
"url": "https://sports.yahoo.com/live/usa-vs-serbia-score-live-updates-nikola-jokic-clashes-with-lebron-and-co-in-marquee-paris-olympics-semifinal-180032898.html",
"image_url": "https://api.dataforseo.com/cdn/i/08091231-1535-0139-0000-df98406ade32:11",
"badges": null
},
{
"type": "top_stories_element",
"source": "NDTV Sports",
"domain": "sports.ndtv.com",
"title": "India vs Spain Highlights, Men's Hockey Bronze Medal Match, Olympics 2024 - \n1st Time In 52 Years: Indian Hockey On Historic High With Olympic Bronze",
"date": "19 hours ago",
"amp_version": false,
"timestamp": "2024-08-08 14:31:42 +00:00",
"url": "https://sports.ndtv.com/olympics-2024/india-vs-spain-mens-hockey-bronze-medal-match-live-score-paris-olympics-2024-ind-vs-esp-live-scorecard-6291617",
"image_url": "https://api.dataforseo.com/cdn/i/08091231-1535-0139-0000-df98406ade32:12",
"badges": null
},
{
"type": "top_stories_element",
"source": "The Independent",
"domain": "www.independent.co.uk",
"title": "Olympics 2024 LIVE: Latest medals and results from Paris 2024",
"date": "7 minutes ago",
"amp_version": false,
"timestamp": "2024-08-09 09:24:42 +00:00",
"url": "https://www.independent.co.uk/sport/olympics/olympics-2024-live-results-medals-team-gb-b2593654.html",
"image_url": "https://api.dataforseo.com/cdn/i/08091231-1535-0139-0000-df98406ade32:13",
"badges": [
"live"
]
}
],
"rectangle": null
}
By identifying the type of content dominating Top Stories for specific queries, you can tailor your news content strategy to align with what’s performing best. For example, if “Video” badges frequently appear for certain keywords, incorporating video content into your stories might improve visibility.
We hope this update enhances your experience with the DataForSEO SERP API and provides greater value to your Top Stories analytics. Check our updated documentation for details, or visit our Visual Guide to SERP Features to learn more about Top Stories and its components.