Skip to main content
POST
/
api
/
ground_news
/
stories
/
top
/ground_news/stories/top
curl --request POST \
  --url https://api.anysite.io/api/ground_news/stories/top \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "edition": "us"
}
'
[
  {
    "id": "<string>",
    "slug": "<string>",
    "@type": "GroundNewsStoryCard",
    "generated_headline": "<string>",
    "description": "<string>",
    "dek": "<string>",
    "summary": "<string>",
    "start": "<string>",
    "image": "<string>",
    "source_count": 123,
    "bias_source_count": 123,
    "left_percent": 123,
    "center_percent": 123,
    "right_percent": 123,
    "left_src_count": 123,
    "cntr_src_count": 123,
    "right_src_count": 123,
    "blindspot_for": "<string>",
    "blindspot_statement": "<string>",
    "coverage_profile_type": "<string>",
    "factuality": {
      "@type": "GroundNewsFactuality",
      "very_high": 123,
      "high": 123,
      "mixed": 123,
      "low": 123,
      "very_low": 123,
      "unknown": 123
    },
    "ownership": {
      "@type": "GroundNewsOwnership",
      "telecom": 123,
      "private_equity": 123,
      "media_conglomerate": 123,
      "billionaire": 123,
      "government": 123,
      "independent": 123,
      "corporation": 123,
      "other": 123,
      "uncategorized": 123
    },
    "place": [],
    "interests": [],
    "sources": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Max number of stories to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
edition
enum<string>
default:us

Regional edition of the top feed

Available options:
us,
international,
uk,
canada,
europe

Response

Successful Response

id
string
required
slug
string
required
@type
string
default:GroundNewsStoryCard
generated_headline
string | null
description
string | null
dek
string | null
summary
string | null
start
string | null
image
string | null
source_count
integer | null
bias_source_count
integer | null
left_percent
number | null
center_percent
number | null
right_percent
number | null
left_src_count
integer | null
cntr_src_count
integer | null
right_src_count
integer | null
blindspot_for
string | null
blindspot_statement
string | null
coverage_profile_type
string | null
factuality
object
ownership
object
place
object[]
interests
object[]
sources
object[]