List entity charts

Returns every entity chart with the headline state of its current edition: the edition date, whether narratives have been written yet, and what sits at rank 1. Each chart’s source says whether its entries measure entity mentions or guest appearances, group tabs the directory into overall, entertainment, and sports, and windows lists the windows that chart publishes. Use the returned category_slug to fetch a full chart. Every chart lists, but leader is omitted for charts the caller may not read: an API key reads every chart, while a session without paid Radar access reads only the all chart.

GET /v1/podcasts/entities/charts

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/entities/charts?window=7d"

200

{
  "data": [
    {
      "category_name": "<string>",
      "category_slug": "<string>",
      "group": "overall",
      "source": "mentions",
      "window": "<string>",
      "windows": [
        "7d"
      ],
      "computed_at": "2023-11-07T05:31:56Z",
      "edition_date": "<string>",
      "enriched_at": "2023-11-07T05:31:56Z",
      "leader": {
        "entity": {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>",
          "company": {
            "id": "<string>",
            "domain": "<string>",
            "ticker": "<string>"
          },
          "description": "<string>",
          "image_url": "<string>",
          "person": {
            "id": "<string>",
            "company": "<string>",
            "image_url": "<string>",
            "title": "<string>"
          },
          "type": {
            "name": "<string>",
            "slug": "<string>"
          },
          "wikipedia_url": "<string>"
        },
        "person": {
          "id": "<string>",
          "name": "<string>",
          "description": "<string>",
          "image_url": "<string>",
          "slug": "<string>"
        },
        "type": "entity"
      },
      "status": "<string>"
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Query Parameters

window · enum<string> · default: 7d

Measurement window for the editions to summarize.

Available options: 7d, 24h

Response

200

application/json

OK

data · object[] · required

List of results

Show child attributes

has_more · boolean · required

Whether more results exist

cursor · string

Pass to next request for more results