# Latest Chart

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Charts
> Source: https://www.podengine.ai/api-docs/get-latest-chart.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/get-latest-chart
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `http://localhost:4000`
**Auth:** No authentication required.

---

#### GET /api/v1/charts/latest (PUBLIC)
**Latest Chart**

Get the latest chart

```bash
curl -X GET "http://localhost:4000/api/v1/charts/latest?category=top+podcasts&chartType=apple&country=us" \
  -H "Content-Type: application/json"
```

**Query schema:**
```json
{
  "type": "object",
  "properties": {
    "chartType": {
      "type": "string",
      "enum": [
        "apple",
        "spotify"
      ],
      "description": "The type of chart, one of apple, spotify"
    },
    "category": {
      "type": "string",
      "description": "The chart category defaulting to 'top podcasts'. Apple podcasts supports the following: \"top podcasts\", \"arts\", \"business\", \"comedy\", \"education\", \"fiction\", \"government\", \"health & fitness\", \"history\", \"kids & family\", \"leisure\", \"music\", \"news\", \"religion & spirituality\", \"science\", \"society & culture\", \"sports\", \"technology\", \"true crime\", \"tv & film\""
    },
    "country": {
      "type": "string",
      "description": "The country of the chart in ISO 3166-1 alpha-2 format, for example \"us\". Defaults to us."
    },
    "positionsLimit": {
      "description": "The number of chart positions to return. If not provided, all positions are returned",
      "type": "number",
      "minimum": 1,
      "maximum": 200
    }
  },
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "options": {
          "type": "object",
          "properties": {
            "chartType": {
              "type": "string",
              "enum": [
                "apple",
                "spotify"
              ],
              "description": "The type of chart, one of apple, spotify"
            },
            "category": {
              "type": "string",
              "description": "The chart category defaulting to 'top podcasts'. Apple podcasts supports the following: \"top podcasts\", \"arts\", \"business\", \"comedy\", \"education\", \"fiction\", \"government\", \"health & fitness\", \"history\", \"kids & family\", \"leisure\", \"music\", \"news\", \"religion & spirituality\", \"science\", \"society & culture\", \"sports\", \"technology\", \"true crime\", \"tv & film\""
            },
            "country": {
              "type": "string",
              "description": "The country of the chart in ISO 3166-1 alpha-2 format, for example \"us\". Defaults to us."
            },
            "positionsLimit": {
              "description": "The number of chart positions to return. If not provided, all positions are returned",
              "type": "number",
              "minimum": 1,
              "maximum": 200
            }
          },
          "additionalProperties": false
        },
        "chart": {
          "nullable": true,
          "type": "object",
          "properties": {
            "chart": {
              "type": "object",
              "properties": {
                "chartType": {
                  "type": "string",
                  "enum": [
                    "apple",
                    "spotify"
                  ],
                  "description": "The type of chart, one of apple, spotify"
                },
                "category": {
                  "type": "string",
                  "description": "The chart category defaulting to 'top podcasts'. Apple podcasts supports the following: \"top podcasts\", \"arts\", \"business\", \"comedy\", \"education\", \"fiction\", \"government\", \"health & fitness\", \"history\", \"kids & family\", \"leisure\", \"music\", \"news\", \"religion & spirituality\", \"science\", \"society & culture\", \"sports\", \"technology\", \"true crime\", \"tv & film\""
                },
                "country": {
                  "type": "string",
                  "description": "The country of the chart in ISO 3166-1 alpha-2 format, for example \"us\". Defaults to us."
                },
                "chartDate": {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "description": "The date of the chart in YYYY-MM-DD format"
                }
              },
              "required": [
                "chartType",
                "category",
                "country",
                "chartDate"
              ],
              "additionalProperties": false
            },
            "positions": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "position": {
                    "type": "number"
                  },
                  "podcastOnChart": {
                    "type": "object",
                    "properties": {
                      "podcastOnChartId": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "imageUrl": {
                        "nullable": true,
                        "type": "string",
                        "format": "uri"
                      }
                    },
                    "required": [
                      "podcastOnChartId",
                      "title",
                      "imageUrl"
                    ],
                    "additionalProperties": false
                  },
                  "podenginePodcast": {
                    "nullable": true,
                    "type": "object",
                    "properties": {
                      "author": {
                        "nullable": true,
                        "type": "string"
                      },
                      "authorityScore": {
                        "nullable": true,
                        "type": "object",
                        "properties": {
                          "calculatedAt": {},
                          "authorityScore": {
                            "type": "number",
                            "description": "This is the weighted total authority score of the podcast, out of 100"
                          },
                          "qualityScore": {
                            "type": "number",
                            "description": "This is the quality score of the podcast, out of 100"
                          },
                          "youtubeScore": {
                            "type": "number",
                            "description": "This is the YouTube score of the podcast, out of 100"
                          },
                          "socialScore": {
                            "type": "number",
                            "description": "This is the social score of the podcast, out of 100"
                          },
                          "engagementScore": {
                            "type": "number",
                            "description": "This is the engagement score of the podcast, out of 100"
                          }
                        },
                        "required": [
                          "calculatedAt",
                          "authorityScore",
                          "qualityScore",
                          "youtubeScore",
                          "socialScore",
                          "engagementScore"
                        ],
                        "additionalProperties": false
                      },
                      "genres": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "id": {
                        "type": "string"
                      },
                      "imageUrl": {
                        "nullable": true,
                        "type": "string"
                      },
                      "language": {
                        "type": "string"
                      },
                      "lastEpisodePublishedAt": {},
                      "slug": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "titleLatest": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "author",
                      "authorityScore",
                      "genres",
                      "id",
                      "imageUrl",
                      "language",
                      "lastEpisodePublishedAt",
                      "slug",
                      "title",
                      "titleLatest"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "position",
                  "podcastOnChart",
                  "podenginePodcast"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "chart",
            "positions"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "options",
        "chart"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status",
    "data"
  ],
  "additionalProperties": false
}
```

---

## See also

- All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt
- Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt
- OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json
- Get an API key: https://www.podengine.ai/get-started
- Support: support@podengine.ai