# NewsAPI Top Headlines API

**Canonical:** https://apis.io/apis/newsapi/newsapi-top-headlines-api/  
**Provider:** NewsAPI — https://apis.io/providers/newsapi/  
**Base URL:** https://newsapi.org/v2  
**Documentation:** https://newsapi.org/

NewsAPI Top Headlines API is one of 3 APIs that [NewsAPI](https://apis.io/providers/newsapi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 3 JSON Schema definitions. Tagged areas include Top Headlines. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 3 JSON Schemas.

Get live top and breaking headlines

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/openapi/newsapi-top-headlines-api-openapi.yml
- **Documentation** — https://newsapi.org/docs
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-article-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-source-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-schema/newsapi-error-schema.json
- **Vocabulary** — https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/vocabulary/newsapi-vocabulary.yml
- **JSONLDContext** — https://raw.githubusercontent.com/api-evangelist/newsapi/refs/heads/main/json-ld/newsapi-context.jsonld

## Other NewsAPI APIs (2)

- [NewsAPI Everything API](https://apis.io/apis/newsapi/newsapi-everything-api/)
- [NewsAPI Sources API](https://apis.io/apis/newsapi/newsapi-sources-api/)

## Tags

Top Headlines

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/newsapi/newsapi-top-headlines-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/newsapi/.