This endpoint returns the subset of news publishers that top headlines (/v2/top-headlines) are available from. It’s mainly a convenience endpoint that you can use to keep track of the publishers available on the API, and you can pipe it straight through to your users.

Request parameters

  • category

    Find sources that display news of this category. Possible options: businessentertainmentgeneral health science sports technology . Default: all categories.

  • country

    Find sources that display news in a specific country. Possible options: ae, ar, at, au,be, bg, br,ca, ch, cn, co, cu, cz, de, eg, fr, gb, gr, hk, hu, id, ie,il, in, it, jp, kr, lt, lv,ma, mx, my, ng, nl, no, nz, ph, pl, pt, ro,rs, ru, sa, se, sg, si, sk, th, tr, tw, ua,us, ve, za, . Default: all countries.

  • apiKeyREQUIRED

    Your API key. Alternatively you can provide this via the X-Api-Key HTTP header.

Response object

  • statusstring

    If the request was successful or not. Options: ok, error. In the case of error a code and messageproperty will be populated.

  • sourcesarray[source]

    The results of the request.

    • idstring

      The identifier of the news source. You can use this with our other endpoints.

    • namestring

      The name of the news source

    • descriptionstring

      A description of the news source

    • urlstring

      The URL of the homepage.

    • categorystring

      The type of news to expect from this news source.

    • languagestring

      The language that this news source writes in.

    • countrystring

      The country this news source is based in (and primarily writes about).