openapi: 3.0.0
servers:
  - url: https://prod.api.market/api/v1/skycraft/world-news-api
info:
  title: "World News API: Global Coverage from 228+ Countries"
  description: Access Real-Time and Historical Reports Through the World News API
  termsOfService: https://worldnewsapi.com/terms
  version: 2.0.1
  contact:
    name: David Urbansky
    email: mail@worldnewsapi.com
paths:
  /search-news:
    get:
      responses:
        "200":
          description: Success
          headers: {}
          content:
            application/json:
              schema:
                type: object
                properties:
                  offset:
                    type: integer
                  number:
                    type: integer
                  available:
                    type: integer
                  news:
                    type: array
                    items:
                      type: object
                      properties:
                        summary:
                          type: string
                          nullable: true
                        image:
                          type: string
                          nullable: true
                        sentiment:
                          type: number
                        author:
                          type: string
                          nullable: true
                        language:
                          type: string
                          nullable: true
                        video:
                          type: string
                          nullable: true
                        title:
                          type: string
                          nullable: true
                        url:
                          type: string
                          nullable: true
                        source_country:
                          type: string
                          nullable: true
                        id:
                          type: integer
                        text:
                          type: string
                          nullable: true
                        category:
                          type: string
                          nullable: true
                        publish_date:
                          type: string
                          nullable: true
                        authors:
                          type: array
                          items:
                            type: string
                            nullable: true
              examples:
                Response:
                  value:
                    offset: 0
                    number: 10
                    available: 83
                    news:
                      - summary: Twenty nine areas around Whitehouse Station, NJ, which was the
                          epicenter of the quake, have since reported rumbles.
                        image: https://nypost.com/wp-content/uploads/sites/2/2024/04/79582612.jpg?quality=75&strip=all&w=1200
                        sentiment: -0.545
                        author: Deirdre Bardolf
                        language: en
                        video: https://cdn.jwplayer.com/videos/70lDQJpg-RyIcpnTz.mp4
                        title: Nearly 30 aftershocks recorded around NJ quake epicenter since Friday
                        url: https://nypost.com/2024/04/06/us-news/nearly-30-aftershocks-recorded-around-nj-quake-epicenter/
                        source_country: us
                        id: 206030983
                        text: New Jersey continues to shake after Friday’s 4.8-magnitude earthquake and
                          likely will continue to do so for some time. Dozens of
                          aftershocks were recorded in the Garden State since
                          the rare quake hit, including one tremor of 3.8 after
                          the initial event. But residents of NYC shouldn’t
                          expect anything beyond possibly a light shake in the
                          coming days. Rumbles were measured in 29 nine areas
                          around Whitehouse Station, NJ, which was the epicenter
                          of the quake, including near Tewksbury and Bedminster,
                          according to the United States Geological Survey. The
                          smaller temblors hit as far as 13 miles away from the
                          epicenter. One clocked in at 1.9 just after 1 a.m.
                          Saturday morning just north of Whitehouse Station —
                          about 45 miles west of NYC — and another at 2.5 just
                          before 7 a.m. near Gladstone, northeast of the
                          epicenter. Over the next week, there is a 74% chance
                          of additional 3-plus magnitude aftershocks, but the
                          USGS does not foresee more than five occurring. There
                          is just a 14% chance of a quake clocking in at a
                          magnitude of 4 or higher, and likely only one will
                          come this week. Over the course of the next month,
                          however, the chance of a 3-plus magnitude quake rises
                          to 84%, while a the chance of a 4 or greater is 18%.
                          It’s almost certain — 98% — that more 3-plus magnitude
                          shakers will come in the next year, the USGS said. The
                          nearly 30 rumbles that followed the first quake aren’t
                          a shock to geologists, though. “We do expect
                          aftershocks like this to occur in the days, weeks and
                          months after the main shock, so this is fully within
                          the realm of what is expected,” USGS research
                          geologist Alex Hatem told The Post. The chance of NYC
                          feeling another rattle, however, is low. A light shake
                          could be possible in the coming days, Hatem said, but
                          nothing like the quake that rocked the Statue of
                          Liberty and City Hall Friday or the aftershock that
                          rippled through later that evening. The quake grounded
                          flights and halted traffic around the Big Apple.
                          “Should this sequence continue as it is, which we
                          expect it to, there won’t be anything greater than
                          what already happened,” Hatem said. Though researchers
                          expect earthquakes to happen “anytime, anywhere,” it
                          is a rare occurrence for New Jersey, which doesn’t lie
                          on an active plate boundary, Hatem said. The incident
                          did occur, however, near the Ramapo Fault, which is an
                          ancient crack in the Earth’s crust. Faults lie on the
                          edges of plates and can sometimes be the site of
                          quakes. New Jersey Gov. Phil Murphy posted on X
                          Saturday that the state’s emergency operations center
                          was deactivated that morning. “We have had no reports
                          of major damage to structures, roadways, or
                          infrastructure as a result of yesterday’s earthquake,”
                          Murphy said. Residents in several homes in Newark were
                          able to return to their homes Friday night after being
                          evacuated over concerns about possible structural
                          damage. Gov. Hochul and Mayor Adams said there were no
                          initial reports of injuries or damage in New York,
                          though it later emerged that the walls of a school gym
                          in Brooklyn suffered several cracks. Engineers with
                          the city Department of Buildings ordered the gymnasium
                          at J.H.S. 218 in East New York shut down until repairs
                          are made. The earthquake was the biggest for the
                          tri-state area since 1884. The USGS recently released
                          a study that showed that about 75% of the US that
                          could experience a damaging earthquake in the next 100
                          years. Friday’s rattle should be a “gentle reminder”
                          to those on the East Coast, however, to be prepared
                          and familiar with “drop, cover and hold on” actions to
                          stay safe in the event of another quake. New York City
                          officials were blasted for emergency alerts that
                          didn’t go out until 25 minutes after the earthquake
                          struck. Some NYC public school alerts didn’t go out
                          until an hour and a half after the shock — and were
                          resent Saturday morning, telling parents that
                          dismissal would proceed as usual.
                        category: environment
                        publish_date: 2024-04-06 22:44:18
                        authors:
                          - Deirdre Bardolf
        "401":
          description: Unauthorized
        "402":
          description: Payment Required
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "406":
          description: Not Acceptable
        "429":
          description: Too Many Requests
      parameters:
        - name: text
          description: The text to match in the news content (at least 3 characters,
            maximum 100 characters). By default all query terms are expected,
            you can use an uppercase OR to search for any terms, e.g. tesla OR
            ford
          schema:
            pattern: .
            maxLength: 100
            type: string
            example: tesla
          required: false
          style: form
          explode: false
          in: query
        - name: source-country
          description: The ISO 3166 country code from which the news should originate.
          schema:
            pattern: .
            maxLength: 100
            type: string
            example: us
          required: false
          style: form
          explode: false
          in: query
        - name: language
          description: The ISO 6391 language code of the news.
          schema:
            pattern: .
            maxLength: 2
            type: string
            example: en
          required: false
          style: form
          explode: false
          in: query
        - name: min-sentiment
          description: The minimal sentiment of the news in range [-1,1].
          schema:
            format: double
            minimum: -1
            maximum: 1
            type: number
            example: -0.8
          required: false
          style: form
          explode: false
          in: query
        - name: max-sentiment
          description: The maximal sentiment of the news in range [-1,1].
          schema:
            format: double
            minimum: -1
            maximum: 1
            type: number
            example: 0.8
          required: false
          style: form
          explode: false
          in: query
        - name: earliest-publish-date
          description: The news must have been published after this date.
          schema:
            pattern: .
            maxLength: 19
            type: string
            example: 2022-04-22 16:12:35
          required: false
          style: form
          explode: false
          in: query
        - name: latest-publish-date
          description: The news must have been published before this date.
          schema:
            pattern: .
            maxLength: 19
            type: string
            example: 2025-01-22 16:12:35
          required: false
          style: form
          explode: false
          in: query
        - name: news-sources
          description: A comma-separated list of news sources from which the news should
            originate.
          schema:
            pattern: .
            maxLength: 10000
            type: string
            example: https://www.bloomberg.com
          required: false
          style: form
          explode: false
          in: query
        - name: authors
          description: A comma-separated list of author names. Only news from any of the
            given authors will be returned.
          schema:
            pattern: .
            maxLength: 300
            type: string
            example: ""
          required: false
          style: form
          explode: false
          in: query
        - name: categories
          description: A comma-separated list of categories. Only news from any of the
            given categories will be returned. Possible categories are politics,
            sports, business, technology, entertainment, health, science,
            lifestyle, travel, culture, education, environment, other. Please
            note that the filter might leave out news, especially in non-English
            languages. If too few results are returned, use the text parameter
            instead.
          schema:
            pattern: .
            maxLength: 300
            type: string
            example: politics,sports,technology
          required: false
          style: form
          explode: false
          in: query
        - name: entities
          description: Filter news by entities (see semantic types).
          schema:
            pattern: .
            maxLength: 10000
            type: string
            example: ORG:Tesla
          required: false
          style: form
          explode: false
          in: query
        - name: location-filter
          description: Filter news by radius around a certain location. Format is
            "latitude,longitude,radius in kilometers". Radius must be between 1
            and 100 kilometers.
          schema:
            pattern: .
            maxLength: 100
            type: string
            example: ""
          required: false
          style: form
          explode: false
          in: query
        - name: sort
          description: The sorting criteria (publish-time).
          schema:
            pattern: .
            maxLength: 100
            type: string
            example: publish-time
          required: false
          style: form
          explode: false
          in: query
        - name: sort-direction
          description: Whether to sort ascending or descending (ASC or DESC).
          schema:
            pattern: .
            maxLength: 4
            type: string
            example: ASC
          required: false
          style: form
          explode: false
          in: query
        - name: offset
          description: The number of news to skip in range [0,10000]
          schema:
            format: int32
            minimum: 0
            maximum: 10000
            type: integer
            example: 0
          required: false
          style: form
          explode: false
          in: query
        - name: number
          description: The number of news to return in range [1,100]
          schema:
            format: int32
            minimum: 1
            maximum: 100
            type: integer
            example: 10
          required: false
          style: form
          explode: false
          in: query
      externalDocs:
        description: Read entire docs
        url: https://worldnewsapi.com/docs/search-news/
      summary: Search News
      tags:
        - News
      description: Search and filter news by text, date, location, category, language,
        and more. The API returns a list of news articles matching the given
        criteria. You can set as many filtering parameters as you like, but you
        have to set at least one, e.g. text or language.
      operationId: searchNews
      deprecated: false
    parameters:
      - &a1
        description: API.market API Key
        in: header
        name: x-api-market-key
        value: Please Login/Signup to get an API Key
        required: true
        schema:
          type: string
  /top-news:
    get:
      responses:
        "200":
          description: Success
          headers: {}
          content:
            application/json:
              schema:
                type: object
                properties:
                  top_news:
                    type: array
                    items:
                      type: object
                      properties:
                        news:
                          type: array
                          items:
                            type: object
                            properties:
                              summary:
                                type: string
                                nullable: true
                              image:
                                type: string
                                nullable: true
                              author:
                                type: string
                                nullable: true
                              id:
                                type: integer
                              text:
                                type: string
                                nullable: true
                              title:
                                type: string
                                nullable: true
                              publish_date:
                                type: string
                                nullable: true
                              url:
                                type: string
                                nullable: true
                              authors:
                                type: array
                                items:
                                  type: string
                                  nullable: true
                  language:
                    type: string
                    nullable: true
                  country:
                    type: string
                    nullable: true
              examples:
                Response:
                  value:
                    top_news:
                      - news:
                          - summary: ...
                            image: https://politicalwire.com/wp-content/uploads/2018/02/PW-podcast-logo.jpg
                            author: Taegan Goddard
                            id: 224767206
                            text: ...
                            title: Jury to Begin Deliberations In Trump Trial
                            publish_date: 2024-05-29 00:10:48
                            url: https://politicalwire.com/2024/05/28/jury-to-begin-deliberations-in-trump-trial/
                            authors:
                              - Taegan Goddard
                          - summary: ...
                            image: https://dims.apnews.com/dims4/default/3446536/2147483647/strip/true/crop/6195x3485+0+323/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fec%2Fd5%2Ff56fdc38f86e38b6217b50083d19%2Fd5ef4afe1cb64825be1349de8fd40df0
                            id: 224839780
                            text: ...
                            title: Jury in Donald Trump's hush money case to begin deliberations
                            publish_date: 2024-05-29 04:30:08
                            url: https://apnews.com/article/trump-trial-deliberations-jury-judge-verdict-390f045e9e8a37f069e82576edd7a842
                            authors: []
                          - summary: ...
                            image: https://whdh.com/wp-content/uploads/sites/3/2024/05/WHDH_2024-05-27_15h27-33-cover.jpg?quality=60&strip=color
                            id: 224936214
                            text: ...
                            title: Jury in Trump's hush money case to begin deliberations after hearing
                              instructions from judge
                            publish_date: 2024-05-29 08:47:26
                            url: https://whdh.com/news/jury-in-trumps-hush-money-case-to-begin-deliberations-after-hearing-instructions-from-judge/
                            authors: []
                          - summary: ...
                            image: https://assets3.cbsnewsstatic.com/hub/i/r/2024/05/29/66524a85-576c-4c40-94ba-cfb04cbb7950/thumbnail/1200x630g3/d2d9c8ea35b659db292c371bdc0a47e8/gettyimages-2154550679.jpg?v=c5044be0004eac09882c007ac02fef6d
                            id: 224956968
                            text: ...
                            video: https://prod.vodvideo.cbsnews.com/cbsnews/vr/hls/2942696_hls/master.m3u8
                            title: Trump trial jury set to begin deliberating verdict today after judge
                              issues instructions
                            publish_date: 2024-05-29 10:00:18
                            url: https://www.cbsnews.com/live-updates/trump-trial-verdict-jury-deliberations-judge-instructions/
                            authors: []
                          - summary: ...
                            image: https://static01.nyt.com/images/2024/05/29/multimedia/29trump-trial-pinned-qzmh/29trump-trial-pinned-qzmh-facebookJumbo-v2.jpg
                            id: 224957034
                            text: ...
                            title: Jury in Trump’s Hush-Money Trial to Begin Deliberations on Wednesday
                            publish_date: 2024-05-29 10:12:08
                            url: https://www.nytimes.com/2024/05/29/nyregion/trump-trial-jury-charges.html
                            authors: []
                          - summary: ...
                            image: https://a57.foxnews.com/static.foxnews.com/foxnews.com/content/uploads/2024/05/931/524/judge-trump.png?ve=1&tl=1
                            id: 224961802
                            text: ...
                            title: Jury to begin deliberations in Trump trial and more top headlines
                            publish_date: 2024-05-29 10:22:36
                            url: https://www.foxnews.com/us/judge-outline-framework-jury-trial-decide-trumps-fate-more-top-headlines
                            authors: []
                      - news:
                          - image: https://cdn.vox-cdn.com/thumbor/WBEMdSSOD_jHJGnNV7hLX88zANk=/0x444:5601x3376/fit-in/1200x630/cdn.vox-cdn.com/uploads/chorus_asset/file/25469085/2152809074.jpg
                            author: Brendan Porath
                            id: 225109966
                            text: ...
                            title: Scottie Scheffler PGA Championship charges set to get dropped
                            publish_date: 2024-05-29 15:24:34
                            url: https://www.sbnation.com/golf/2024/5/29/24167024/scottie-scheffler-pga-championship-louisville-police-drop-charges
                            authors:
                              - Brendan Porath
                          - summary: ...
                            image: https://www.pilotonline.com/wp-content/uploads/2024/05/Scheffler_Arrest_Golf_86723_6d56d8.jpg?w=1024
                            id: 225118216
                            text: ...
                            title: Charges against world’s top golfer Scottie Scheffler dropped after arrest
                              outside PGA Championship
                            publish_date: 2024-05-29 17:05:55
                            url: https://www.pilotonline.com/2024/05/29/charges-against-worlds-top-golfer-scottie-scheffler-dropped-after-arrest-outside-pga-championship/
                            authors: []
                          - summary: ...
                            image: https://www.twincities.com/wp-content/uploads/2024/05/Scheffler_Arrest_Golf_86723_6d56d8.jpg?w=1024
                            id: 225118304
                            text: ...
                            title: Charges against world’s top golfer Scottie Scheffler dropped after arrest
                              outside PGA Championship
                            publish_date: 2024-05-29 17:05:55
                            url: https://www.twincities.com/2024/05/29/charges-against-worlds-top-golfer-scottie-scheffler-dropped-after-arrest-outside-pga-championship/
                            authors: []
                          - summary: ...
                            image: https://wsvn.com/wp-content/uploads/sites/2/2024/04/240414_Scottie_Scheffler.jpg?quality=60&strip=color
                            id: 225119550
                            text: ...
                            title: Charges against world's top golfer Scottie Scheffler dropped after arrest
                              outside PGA Championship
                            publish_date: 2024-05-29 17:10:09
                            url: https://wsvn.com/sports/charges-against-worlds-top-golfer-scottie-scheffler-dropped-after-arrest-outside-pga-championship/
                            authors: []
                      - news:
                          - summary: ...
                            image: https://media.nbcwashington.com/2019/09/AP163564666366.jpg?quality=85&strip=all&fit=722%2C406
                            id: 225012756
                            text: ...
                            title: Pandas to return to DC's National Zoo
                            publish_date: 2024-05-29 12:37:10
                            url: https://www.nbcwashington.com/news/local/national-zoo-expected-to-make-announcement-about-panda-program/3627045/
                            authors: []
                          - summary: ...
                            image: https://dims.apnews.com/dims4/default/1f5b9aa/2147483647/strip/true/crop/3382x1902+0+176/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fc4%2F1e%2F69094cc265243956d243348db814%2F71b160bbb0204eb594474a4934fb0df6
                            id: 225017360
                            text: ...
                            title: Giant pandas are returning to D.C.'s National Zoo
                            publish_date: 2024-05-29 12:51:08
                            url: https://apnews.com/article/giant-pandas-washington-zoo-china-764f8016d98c01ab579bdbb6dcc3dd6b
                            authors: []
                          - summary: ...
                            image: https://www.baltimoresun.com/wp-content/uploads/2024/05/Giant_Pandas_89303.jpg?w=1024
                            id: 225017634
                            text: ...
                            title: 2 new giant pandas are returning to Washington’s National Zoo from China
                              by the end of the year
                            publish_date: 2024-05-29 12:52:08
                            url: https://www.baltimoresun.com/2024/05/29/2-new-giant-pandas-are-returning-to-washingtons-national-zoo-from-china-by-the-end-of-the-year/
                            authors: []
                    language: en
                    country: us
        "401":
          description: Unauthorized
        "402":
          description: Payment Required
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "406":
          description: Not Acceptable
        "429":
          description: Too Many Requests
      parameters:
        - name: source-country
          description: The ISO 3166 country code of the country for which top news should
            be retrieved.
          schema:
            pattern: .
            maxLength: 2
            type: string
            example: us
          required: true
          style: form
          explode: false
          in: query
        - name: language
          description: The ISO 6391 language code of the top news. The language must be
            one spoken in the source-country.
          schema:
            pattern: .
            maxLength: 2
            type: string
            example: en
          required: true
          style: form
          explode: false
          in: query
        - name: date
          description: The date for which the top news should be retrieved. If no date is
            given, the current day is assumed.
          schema:
            pattern: .
            maxLength: 10
            type: string
            example: 2024-05-30
          required: false
          style: form
          explode: false
          in: query
        - name: headlines-only
          description: Whether to only return basic information such as id, title, and url
            of the news.
          schema:
            type: boolean
            example: false
          required: false
          style: form
          explode: false
          in: query
      externalDocs:
        description: Read entire docs
        url: https://worldnewsapi.com/docs/top-news/
      summary: Top News
      tags:
        - News
      description: Get the top news from a country in a language for a specific date.
        The top news are clustered from multiple sources in the given country.
        The more news in a cluster the higher the cluster is ranked.
      operationId: topNews
      deprecated: false
    parameters:
      - *a1
  /retrieve-front-page:
    get:
      responses:
        "200":
          description: Success
          headers: {}
          content:
            application/json:
              schema:
                type: object
                properties:
                  front_page:
                    type: object
                    properties:
                      name:
                        type: string
                        nullable: true
                      date:
                        type: string
                        nullable: true
                      country:
                        type: string
                        nullable: true
                      image:
                        type: string
                        nullable: true
                      language:
                        type: string
                        nullable: true
              examples:
                Response:
                  value:
                    front_page:
                      name: Herald Sun
                      date: 2024-07-09
                      country: au
                      image: https://img.worldnewsapi.com/front-pages/herald-sun-2024-07-09-ota3mg51.jpg
                      language: en
        "401":
          description: Unauthorized
        "402":
          description: Payment Required
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "406":
          description: Not Acceptable
        "429":
          description: Too Many Requests
      parameters:
        - name: source-country
          description: The ISO 3166 country code of the newspaper publication.
          schema:
            pattern: .
            maxLength: 2
            type: string
            example: au
          required: false
          style: form
          explode: false
          in: query
        - name: source-name
          description: The identifier of the publication see attached list.
          schema:
            pattern: .
            maxLength: 100
            type: string
            example: herald-sun
          required: false
          style: form
          explode: false
          in: query
        - name: date
          description: The date for which the front page should be retrieved. You can also
            go into the past, the earliest date is 2024-07-09.
          schema:
            pattern: .
            maxLength: 10
            type: string
            example: 2024-07-09
          required: false
          style: form
          explode: false
          in: query
      externalDocs:
        description: Read entire docs
        url: https://worldnewsapi.com/docs/newspaper-front-pages/
      summary: Retrieve Newspaper Front Page
      tags:
        - News
      description: "Get the front pages of newspapers from around the world. The API
        provides images of the front pages of newspapers from different
        countries. Here's an example of some of today's newspapers:"
      operationId: retrieveNewspaperFrontPage
      deprecated: false
    parameters:
      - *a1
  /retrieve-news:
    get:
      responses:
        "200":
          description: Success
          headers: {}
          content:
            application/json:
              schema:
                type: object
                properties:
                  news:
                    type: array
                    items:
                      type: object
                      properties:
                        summary:
                          type: string
                          nullable: true
                        image:
                          type: string
                          nullable: true
                        sentiment:
                          type: number
                        language:
                          type: string
                          nullable: true
                        title:
                          type: string
                          nullable: true
                        url:
                          type: string
                          nullable: true
                        source_country:
                          type: string
                          nullable: true
                        id:
                          type: integer
                        text:
                          type: string
                          nullable: true
                        category:
                          type: string
                          nullable: true
                        publish_date:
                          type: string
                          nullable: true
                        authors:
                          type: array
                          items:
                            type: string
                            nullable: true
              examples:
                Response:
                  value:
                    news:
                      - summary: ...
                        image: https://www.amnesty.org/en/wp-content/uploads/2021/06/272748-1024x433.jpg
                        sentiment: -0.176
                        language: en
                        title: While China and the US squabble, the world’s debt and climate crises
                          worsen - Amnesty International
                        url: https://www.amnesty.org/en/latest/news/2020/09/while-china-and-the-us-squabble-the-world-debt-and-climate-crises-worsen/
                        source_country: mx
                        id: 2352
                        text: ...
                        category: politics
                        publish_date: 2020-09-11 18:05:26
                        authors:
                          - Amnesty International
                          - William Nee
                      - summary: ...
                        image: https://www.amnesty.org/en/wp-content/uploads/2021/06/264281-1024x433.jpg
                        sentiment: -0.449
                        language: en
                        title: Sexual violence against Hong Kong protesters – what’s going on? - Amnesty
                          International
                        url: https://www.amnesty.org/en/latest/news/2019/12/sexual-violence-against-hong-kong-protesters/
                        source_country: mx
                        id: 2354
                        text: ...
                        category: politics
                        publish_date: 2019-12-20 11:14:17
                        authors:
                          - Amnesty International
        "401":
          description: Unauthorized
        "402":
          description: Payment Required
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "406":
          description: Not Acceptable
        "429":
          description: Too Many Requests
      parameters:
        - name: ids
          description: A comma separated list of news ids.
          schema:
            pattern: .
            maxLength: 10000
            type: string
            example: 2352,2354
          required: true
          style: form
          explode: false
          in: query
      externalDocs:
        description: Read entire docs
        url: https://worldnewsapi.com/docs/retrieve-news/
      summary: Retrieve News Articles by Ids
      tags:
        - News
      description: Retrieve information about one or more news articles by their ids.
        The ids can be retrieved from the search news or top news APIs.
      operationId: retrieveNewsArticlesByIds
      deprecated: false
    parameters:
      - *a1
  /extract-news:
    get:
      responses:
        "200":
          description: Success
          headers: {}
          content:
            application/json:
              schema:
                type: object
                properties:
                  title:
                    type: string
                    nullable: true
                  text:
                    type: string
                    nullable: true
                  url:
                    type: string
                    nullable: true
                  image:
                    type: string
                    nullable: true
                  images:
                    type: array
                    items:
                      type: object
                      properties:
                        width:
                          type: integer
                        title:
                          type: string
                          nullable: true
                        url:
                          type: string
                          nullable: true
                        height:
                          type: integer
                  video:
                    type: string
                    nullable: true
                  videos:
                    type: array
                    items:
                      type: object
                      properties:
                        summary:
                          type: string
                          nullable: true
                        duration:
                          type: integer
                        thumbnail:
                          type: string
                          nullable: true
                        title:
                          type: string
                          nullable: true
                        url:
                          type: string
                          nullable: true
                  publish_date:
                    type: string
                    nullable: true
                  author:
                    type: string
                    nullable: true
                  authors:
                    type: array
                    items:
                      type: string
                      nullable: true
                  language:
                    type: string
                    nullable: true
              examples:
                Response:
                  value:
                    title: Known terrorist spent year in US after being wrongly released by feds —
                      and GOP lawmakers demand answers
                    text: "A Somali terrorist was allowed into the country and was able to operate
                      freely for almost a year before authorities realized their
                      error and rearrested him. Republican lawmakers are
                      demanding information from Homeland Security Secretary
                      Alejandro Mayorkas about what happened to the man — and
                      whether US citizens funded any part of his journey to or
                      stay in the US. The 27-year-old Somalian — who so far has
                      not been identified by name — was on the watchlist as “a
                      confirmed member of al Shabaab” involved in the use,
                      manufacture or transportation of explosives or firearms,
                      but a border bungle meant he was released after initially
                      being arrested for crossing into the country illegally in
                      California in March 2023. A letter from Republican
                      lawmakers seeks to find the al-Shabaab member’s path from
                      illegally crossing the border to Minnesota, were he was
                      eventually rearrested in January, and whether he received
                      any government benefits. It also seeks to find if he took
                      a commercial flight with US citizens to reach their state
                      and if his travel was funded with taxpayer dollars,
                      according to the Tuesday letter, first obtained by The
                      Post. The letter states: “Due to Minnesota’s far distance
                      from the border, it is not an easy task for migrants to
                      travel to the state … “Did the al-Shabbab terrorist travel
                      to Minnesota with the assistance, either direct or
                      indirect of an [Non-Governmental Organization]? If so,
                      which NGO was responsible for transporting the individual
                      to Minnesota?” The terrorist organization member had
                      initially crossed into California and been arrested by the
                      Border Patrol. However, the Terrorist Screening Center
                      determined he was a “mismatch” to the terror watchlist,
                      leading to his release. Nearly a year later, Immigration
                      and Customs Enforcement (ICE) nabbed him after federal
                      authorities made a “redetermination” and realized he was
                      associated with the Somalian militant group. Al-Shabaab
                      was formed as the militant wing of the Somali Council of
                      Islamic Courts, which controlled the southern part of the
                      country in late 2006. Its rule was defeated in 2007,
                      according to the Office of the Director of National
                      Intelligence, but it has since operated as an underground
                      network and is involved in wars in and around Somalia. It
                      was designated a terrorist organization in 2008 by the US
                      government and is notorious for carrying out bombings and
                      suicide attacks. In 2013, al-Shabaab was responsible for a
                      massacre at the Westgate mall in Kenya, killing 67
                      individuals. US forces have conducted six strikes in
                      Somalia against al-Shabaab already this year, killing two
                      dozen militants in the latest actions, according to CNN.
                      In a February press conference, ICE Acting Director
                      Patrick Lechleitner said his agency arrested the
                      individual “within 48 hours” of learning his true
                      identity. “The Biden administration’s open-borders agenda
                      allowed a known terrorist to roam freely throughout our
                      state, and now they must answer for their inexcusable
                      negligence,” House Majority Whip Tom Emmer (R-Minn.) said
                      in a statement to The Post regarding the probe. The Border
                      Patrol has recorded an ever-growing number of migrants
                      listed on the terror watchlist attempting to enter the US
                      illegally in recent years. Between October 2023 and
                      February, agents have already recorded 70 encounters at
                      both the southern and northern borders, according to
                      federal data. There were 172 such encounters recorded in
                      fiscal year 2023, which ran from October 2022 to September
                      2023, 98 in fiscal year 2022, 16 in fiscal year 2021 and
                      14 between fiscal years 2017 and 2020. In March, Border
                      Patrol agents apprehended Lebanese national Basel Bassel
                      Ebbadi, 22, who told personnel that he came to the US “to
                      try to make a bomb,” according to internal federal
                      documents first obtained by The Post. Ebbadi admitted to a
                      border agent that he is a member of Hezbollah and was
                      later confirmed as a “positive match” on the terror
                      watchlist."
                    url: https://nypost.com/2024/04/02/us-news/lawmakers-demand-to-know-if-taxpayers-funded-al-shabaab-terrorist/
                    image: https://nypost.com/wp-content/uploads/sites/2/2024/04/al-shabaab-terrorist-migrant-border-crossing-california-minnesota-mayorkas-comp-02.jpg?quality=75&strip=all&w=1200
                    images:
                      - width: 879
                        title: Masked al-Shabaab members hold up weapons
                        url: https://nypost.com/wp-content/uploads/sites/2/2024/04/2010-somalias-hardline-islamist-rebel-39796525.jpg?w=1024
                        height: 590
                      - width: 787
                        title: Members of al-Shabaab
                        url: https://nypost.com/wp-content/uploads/sites/2/2024/04/2010-al-shabaab-said-friday-39807171.jpg?w=1024
                        height: 590
                      - width: 943
                        title: Border Patrol agents apprehend migrants
                        url: https://nypost.com/wp-content/uploads/sites/2/2024/04/migrants-placed-vans-u-s-78334041.jpg?w=1024
                        height: 590
                      - width: 885
                        title: Migrants await to be transported by Border Patrol agents
                        url: https://nypost.com/wp-content/uploads/sites/2/2024/04/asylum-seeking-migrants-stand-line-71972565.jpg?w=1024
                        height: 590
                      - width: 885
                        title: Border Patrol vehicle
                        url: https://nypost.com/wp-content/uploads/sites/2/2024/04/u-s-border-patrol-vehicle-56717052.jpg?w=1024
                        height: 590
                      - width: 1200
                        url: https://nypost.com/wp-content/uploads/sites/2/2024/04/al-shabaab-terrorist-migrant-border-crossing-california-minnesota-mayorkas-comp-02.jpg?quality=75&strip=all&w=1200
                        height: 800
                    video: https://cdn.jwplayer.com/videos/Den1Nq47-RyIcpnTz.mp4
                    videos:
                      - summary: "Today's Video Headlines: 4/2/24"
                        duration: 61
                        thumbnail: https://cdn.jwplayer.com/v2/media/Den1Nq47/poster.jpg?width=720
                        title: Today's Video Headlines
                        url: https://cdn.jwplayer.com/videos/Den1Nq47-RyIcpnTz.mp4
                    publish_date: 2024-04-02 17:13:12
                    author: Jennie Taer
                    authors:
                      - Jennie Taer
                    language: en
        "401":
          description: Unauthorized
        "402":
          description: Payment Required
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "406":
          description: Not Acceptable
        "429":
          description: Too Many Requests
      parameters:
        - name: url
          description: The url of the news.
          schema:
            pattern: .
            maxLength: 1000
            type: string
            example: https://www.bbc.com/news/world-us-canada-59340789
          required: true
          style: form
          explode: false
          in: query
        - name: analyze
          description: Whether to analyze the news (extract entities etc.)
          schema:
            type: boolean
            example: true
          required: true
          style: form
          explode: false
          in: query
      externalDocs:
        description: Read entire docs
        url: https://worldnewsapi.com/docs/extract-news/
      summary: Extract News
      tags:
        - News
      description: Extract a news article from a website to a well structure JSON
        object. The API will return the title, text, URL, images, videos,
        publish date, authors, language, source country, and sentiment of the
        news article.
      operationId: extractNews
      deprecated: false
    parameters:
      - *a1
  /extract-news-links:
    get:
      responses:
        "200":
          description: Success
          headers: {}
          content:
            application/json:
              schema:
                type: object
                properties:
                  news_links:
                    type: array
                    items:
                      type: string
                      nullable: true
              examples:
                Response:
                  value:
                    news_links:
                      - https://www.nytimes.com/2023/10/07/opinion/wnba-liberty-championship.html
                      - https://www.nytimes.com/2023/10/08/business/economy/labor-strikes.html
                      - https://www.nytimes.com/2023/10/08/dining/sunday-calls-for-old-fashioned-beef-stew.html
        "401":
          description: Unauthorized
        "402":
          description: Payment Required
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "406":
          description: Not Acceptable
        "429":
          description: Too Many Requests
      parameters:
        - name: url
          description: The url of the news.
          schema:
            pattern: .
            maxLength: 1000
            type: string
            example: https://www.bbc.com/news/world-us-canada-59340789
          required: true
          style: form
          explode: false
          in: query
        - name: analyze
          description: Whether to analyze the news (extract entities etc.)
          schema:
            type: boolean
            example: true
          required: true
          style: form
          explode: false
          in: query
      externalDocs:
        description: Read entire docs
        url: https://worldnewsapi.com/docs/extract-news-links/
      summary: Extract News Links
      tags:
        - News
      description: Extract news links from a news website.
      operationId: extractNewsLinks
      deprecated: false
    parameters:
      - *a1
  /feed.rss:
    get:
      responses:
        "200":
          description: Success
          headers: {}
          content:
            application/xml:
              schema:
                type: object
        "401":
          description: Unauthorized
        "402":
          description: Payment Required
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "406":
          description: Not Acceptable
        "429":
          description: Too Many Requests
      parameters:
        - name: url
          description: The url of the news.
          schema:
            pattern: .
            maxLength: 1000
            type: string
            example: https://www.bbc.com/news/world-us-canada-59340789
          required: true
          style: form
          explode: false
          in: query
        - name: analyze
          description: Whether to analyze the news (extract entities etc.)
          schema:
            type: boolean
            example: true
          required: true
          style: form
          explode: false
          in: query
      externalDocs:
        description: Read entire docs
        url: https://worldnewsapi.com/docs/website-to-rss-feed/
      summary: News Website to RSS Feed
      tags:
        - News
      description: Turn a news website into an RSS feed. Any page of a news website
        can be turned into an RSS feed. Provide the URL to the page and the API
        will return an RSS feed with the latest news from that page.
      operationId: newsWebsiteToRSSFeed
      deprecated: false
    parameters:
      - *a1
  /geo-coordinates:
    get:
      responses:
        "200":
          description: Success
          headers: {}
          content:
            application/json:
              schema:
                type: object
                properties:
                  latitude:
                    type: number
                  longitude:
                    type: number
                  city:
                    type: string
                    nullable: true
              examples:
                Response:
                  value:
                    latitude: 35.652832
                    longitude: 139.839478
                    city: Tokyo
        "401":
          description: Unauthorized
        "402":
          description: Payment Required
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "406":
          description: Not Acceptable
        "429":
          description: Too Many Requests
      parameters:
        - name: location
          description: The address or name of the location.
          schema:
            pattern: .
            maxLength: 1000
            type: string
            example: Tokyo, Japan
          required: true
          style: form
          explode: false
          in: query
      externalDocs:
        description: Read entire docs
        url: https://worldnewsapi.com/docs/get-geo-coordinates/
      summary: Get Geo Coordinates
      tags:
        - News
      description: Retrieve the latitude and longitude of a location name. Given this
        information you can fill the location-filter parameter in the news
        search endpoint.
      operationId: getGeoCoordinates
      deprecated: false
    parameters:
      - *a1
components:
  schemas: {}
  securitySchemes: {}
security: {}
tags:
  - name: news
    description: Operations related to news
  - name: scraping
    description: Operations related to scraping
  - name: search
    description: Operations related to search
