×

News API documentation

News API overview

News API is simple HTTP REST API for searching and retrieving live articles from all over the web.  ContextualWeb News API makes it easy to integrate cognitive news searching capabilities into your applications. The API provides a similar experience to ContextualWeb News API using your own custom search domain.

Be aware that the ContextualWeb News Search API provides news search results only. Use the Web Search API and Image Search API for other types of web content.

Header Parameters:

X-RapidAPI-HostStringcontextualwebsearch-websearch-v1.p.rapidapi.com
X-RapidAPI-KeyStringGet API Key

Required parameters:

qStringThe user's search query string
pageNumberNumberThe page to view
pageSizeNumberThe number of items per page. The maximum value is 50
autoCorrectBooleanAutomatically correct spelling
safeSearchBooleanFilter results for adult content

Optional parameters:

fromPublishDateStringShow only articles published after fromPublishedDate.
Click here for the allowed DateTime Formats.
toPublishDateStringShow only articles published after toPublishedDate.
Click here for the allowed DateTime Formats.

Response 200:

{
  "_type": "news",
  "didUMean": "",
  "totalCount": 2311,
  "relatedSearch": [
    "scooter braun",
    "cats",
    "concerts",
    "ariana grande",
    "judi dench",
    "jennifer hudson",
    "<b>taylor swift</b> score 10",
    "trailer",
    "prime day",
    "off drama with fun",
    "new york",
    "stars"
  ],
  "value": [
    {
      "title": "Kunci Gitar / Chord <b>Taylor Swift</b>  End Game (ft. Ed Sheeran & Future )",
      "url": "https://berbagi-chord.com/kunci-gitar-chord-taylor-swift-end-game-ft-ed-sheeran-future",
      "description": "kunci gitar end game, chord end game, kunci gitar <b>taylor swift</b> end game, chord end game <b>taylor swift</b>, lirik lagu end game <b>taylor swift</b> edsheeran future, kunci gitar end game <b>taylor swift</b>",
      "body": "Knew it when I was young, we connected, when we were little bit oldernC                         GnBoth sprung, I got issues and chips on both of my shouldersnFnReputation precedes me, and rumors are knee-deepnC                         GnThe truth is its easier to ignore it, believe menFnEven when wed argue, wed not do it for longnC                       GnAnd you understand the good and bad end up in a songnFnFor all your beautiful traits and the way you do it with easenC                    N.C.nFor all my flaws, paranoia, and insecuritiesnFnIve made mistakes and made some choices, thats hard to denynC                                GnAfter the storm, something was born on the fourth of JulynFnIve passed days without fun, this end game is the onenCnWith four words on the tip of my tongue, Ill never say itnnI dont wanna touch you, I dont wanna benCnJust another ex-love you dont wanna seenDmnI dont wanna miss you (I dont wanna miss you) like the other girls donEm            FnI dont",
      "keywords": "kunci gitar taylor swift end game,chord end game taylor swift,future",
      "language": "en",
      "isSafe": true,
      "datePublished": "2019-07-29T21:06:00",
      "provider": {
        "name": "berbagi-chord"
      },
      "image": {
        "url": "http://berbagi-chord.com/wp-content/uploads/2017/09/kunci-gitar-taylor-swift.jpg",
        "height": 480,
        "width": 480,
        "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=8452069667708416433",
        "thumbnailHeight": 240,
        "thumbnailWidth": 240,
        "base64Encoding": null
      }
    },
    {
      "title": "Orlando Bloom on 'loving, healing' with fiancee Katy Perry",
      "url": "http://rssfeeds.usatoday.com/~/604977894/0/usatoday-newstopstories~Orlando-Bloom-finds-joy-with-fiancee-Katy-Perry-and-the-end-of-her-feud-with-Taylor-Swift/",
      "description": "The actor wants "peace and unity" from the end of fiancee Katy Perry's feud with <b>Taylor Swift</b>, and "light" from his new Amazon series, "Carnival Row."",
      "body": "The actor wants "peace and unity" from the end of fiancee Katy Perry's feud with Taylor Swift, and "light" from his new Amazon series, "Carnival Row."n",
      "keywords": "with fiancee katy perry,with taylor swift,orlando bloom,amazon",
      "language": "en",
      "isSafe": true,
      "datePublished": "2019-07-28T19:54:44",
      "provider": {
        "name": "usatoday"
      },
      "image": {
        "url": "https://www.gannett-cdn.com/presto/2019/07/27/USAT/05fbbf63-73c7-4455-af0d-7bbb3d86db56-GTY_1164578138.JPG",
        "height": 2667,
        "width": 4000,
        "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=6365373702941512636",
        "thumbnailHeight": 249,
        "thumbnailWidth": 373,
        "base64Encoding": null
      }
    },
    {
      "title": "This Week In Music: BTS, A$AP And <b>Taylor Swift</b> Fans All Have A Complaint  Deadline",
      "url": "https://deadline.com/2019/07/this-week-in-music-bts-aap-rocky-taylor-swift-1202655638/",
      "description": "This Week In Music: BTS, A$AP And <b>Taylor Swift</b> Fans All Have A Complaint",
      "body": "added a newnK-pop category this year, but fans of boy band BTS feel it ghettoizes their faves and segregates them from competing with other top pop gropus. The BTS Arm is using the hashtag #VMAsRacist to denote their displeasure. BTS received four nominations for the VMAs but none in the top categories like Artist of the Year.nTAYLOR SWIFT FANS UPSET, TOO:n The Swifties were up in arms this week when news broke that Democrat presidential candidate Kamala Harris held a fundraiser at Taylor Swift arch-rival Scooter Brauns home in Brentwood, Calif. Katy Perry, who recently settled a feud with Swift, was one of the more prominent attendees, along with Ariana Grande and Demi Lovato.n",
      "keywords": "taylor swift fans,music,bts",
      "language": "en",
      "isSafe": true,
      "datePublished": "2019-07-27T18:42:58",
      "provider": {
        "name": "deadline"
      },
      "image": {
        "url": "https://pmcdeadline2.files.wordpress.com/2017/08/taylor-swift-1503667315-640x305.jpg?w=640",
        "height": 305,
        "width": 640,
        "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=679354246716510236",
        "thumbnailHeight": 171,
        "thumbnailWidth": 358,
        "base64Encoding": null
      }
    },
    {
      "title": "<b>Taylor Swift</b> pretends to be a bartender and waitress in cringe ad",
      "url": "https://metro.co.uk/2019/07/27/taylor-swift-is-all-about-the-dollar-as-she-pretends-to-be-a-bartender-and-waitress-in-cringe-ad-10472176/",
      "description": "<b>Taylor Swift</b> pretends to be a clumsy bartender and waitress in a new commercial for credit card company Capital One.",
      "body": "Taylor Swift pretends to be a clumsy bartender and waitress in a new commercial for credit card company Capital One.",
      "keywords": "taylor swift pretends to be,bartender and waitress,capital",
      "language": "en",
      "isSafe": true,
      "datePublished": "2019-07-27T14:27:53",
      "provider": {
        "name": "metro"
      },
      "image": {
        "url": "https://i0.wp.com/metro.co.uk/wp-content/uploads/2019/07/Taylor-Swift-Capital-One-1-093a_1564237694.jpg?quality=90&strip=all&w=1200&h=630&crop=1&zoom=1&ssl=1",
        "height": 630,
        "width": 1200,
        "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=7609218702746895738",
        "thumbnailHeight": 236,
        "thumbnailWidth": 449,
        "base64Encoding": null
      }
    },
    {
      "title": "<b>Taylor Swift</b> waits tables and spills drinks in a new commercial",
      "url": "http://kswt.com/news/national-world/bear-tries-to-break-into-steal-pot-store-dumpster/1100333013/entertainment/celebrity/taylor-swift-waits-tables-and-spills-drinks-in-a-new-commercial/1100471468",
      "description": "<b>Taylor Swift</b> makes a believable diner waitress and an awful bartender.. Get the latest Yuma and Imperial Valley news, sports and weather from KYMA, KSWT, KECY and KESE.",
      "body": "(CNN) - Taylor Swift makes a believable diner waitress and an awful bartender.nThankfully, she doesn'tnneed the tipsn.nThe "Archer" singer is playing a variety of servers in a new credit card ad that release Friday. She's got her signature red lip and blonde hair, and at one point fans even recognize it's Swift behind the counter. She is wearing a "Taylor" name tag though, in case you can't figure out it's her.nThe singer also plays herself as an adorable server in an old-fashioned ice cream shop. The 30-second commercial features her song "ME!" from her new album, "Lover."nThe-CNN-Wire",
      "keywords": "taylor swift waits,new commercial,s and spills,s tables,s drinks",
      "language": "en",
      "isSafe": true,
      "datePublished": "2019-07-27T13:02:21",
      "provider": {
        "name": "kswt"
      },
      "image": {
        "url": "https://static.lakana.com/npg-global-us-east-1/photo/2019/04/09/Taylor%20Swift%20Jan%206%202019.jpg_38025403_ver1.0_1280_720.jpg",
        "height": 720,
        "width": 1280,
        "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=963396486398557792",
        "thumbnailHeight": 270,
        "thumbnailWidth": 480,
        "base64Encoding": null
      }
    },
    {
      "title": "Live Nation ticket scandal shows musicians can learn from <b>Taylor Swift</b>  Quartzy",
      "url": "http://qz.com/quartzy/1674790",
      "description": "Bands like Metallica have had their tickets sold directly to the secondary market. Economics gives them a better choice, as TSwift has shown.",
      "body": "Not messing around with scalpers.nLOOK WHAT YOU MADE ME DOnThe Live Nation scandal shows the concert industry needs to learn economics from Taylor SwiftnBynDan KopfnJuly 27, 2019nBillboard magazine reports that Live Nation, the concert promoter and ticket sales company, has allowed artists to directly sell concert tickets onnlike Stuhbub.nIts a peculiar scandal.nArtists were able to sell their tickets above face value and, as a result, generate more revenue. Live Nation told Billboard that about a dozen artists asked for tickets to sell on resale markets in 2016 and 2017. One of the acts who had their tickets directly sold on resale sites was Metallica. The popular metal bands members claim they were unaware that the ticketing consultant they hired had made this decision.nThe major impact of artists selling their ticket on resale markets is arguably a good one. Rather than letting scalpers earn money by marking up tickets for resale, performers were able to retain more revenue themselv",
      "keywords": "live nation ticket scandal shows,learn from taylor swift",
      "language": "en",
      "isSafe": true,
      "datePublished": "2019-07-27T11:30:00",
      "provider": {
        "name": "qz"
      },
      "image": {
        "url": "https://cms.qz.com/wp-content/uploads/2018/10/TaylorSwift.jpg?quality=75&strip=all&w=1400",
        "height": 2254,
        "width": 4000,
        "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=1498059264497589244",
        "thumbnailHeight": 210,
        "thumbnailWidth": 372,
        "base64Encoding": null
      }
    },
    {
      "title": "<b>Taylor Swift</b> to be felicitated with first-ever Icon Award at 2019 Teen Choice Awards on 11 August- Entertainment News, Firstpost",
      "url": "https://www.firstpost.com/entertainment/taylor-swift-to-be-felicitated-with-first-ever-icon-award-at-2019-teen-choice-awards-on-11-august-7065291.html",
      "description": "Singer <b>Taylor Swift</b> will be honoured with the inaugural Icon Award at the 2019 Teen Choice Awards.",
      "body": "Jul 27, 2019 10:34:39 ISTnSinger Taylor Swift will be honoured with the inaugural Icon Award at the 2019 Teen Choice Awards.nThe 29-year-old singer will be the first recipient of the award. She will receive the special honour at the annual award show, scheduled to take place next month.nTaylor Swift. Image from Twittern"As one of the best-selling music artists of all time, with more than 50 million albums sold, Taylor Swift is a pop culture icon whose accolades and achievements go beyond topping music charts and selling out stadiums worldwide," a statement from FOX, obtained bynVarietyn, said.n"Swift is also one of today's biggest social influencers, using her voice and platform to inspire and create positive change," it added.nThe 2019 Teen Choice Awards will also see popular boy band, the Jonas Brothers, honoured with the Decade Award, which celebrates the group's evolution over the past 10 years.nA number of celebrities, includingnAvengers: Endgamenstar Robert Downey Jr., Jessica Al",
      "keywords": "entertainment news,taylor swift,firstpost",
      "language": "en",
      "isSafe": true,
      "datePublished": "2019-07-27T09:34:00",
      "provider": {
        "name": "firstpost"
      },
      "image": {
        "url": "https://images.firstpost.com/wp-content/uploads/2019/04/Taylor-min.jpg",
        "height": 625,
        "width": 1200,
        "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=565363904181325754",
        "thumbnailHeight": 156,
        "thumbnailWidth": 299,
        "base64Encoding": null
      }
    },
    {
      "title": "How <b>Taylor Swift</b> became a femme fatale ... with a little help from Sylvia Plath",
      "url": "https://menafn.com/1098812278/How-Taylor-Swift-became-a-femme-fatalewith-a-little-help-from-Sylvia-Plath?src=Rss",
      "description": "(MENAFN - The Conversation) In the opening shots of the video for herrecord breakingnew single'Look What You Made Me Do' , we see the zombie former",
      "body": "(MENAFN - The Conversation) In the opening shots of the video for herrecord breakingnew single'Look What You Made Me Do' , we see the zombie former",
      "keywords": "how taylor swift became,little help from sylvia,conversation",
      "language": "en",
      "isSafe": true,
      "datePublished": "2019-07-27T04:08:02",
      "provider": {
        "name": "menafn"
      },
      "image": {
        "url": "https://menafn.com/updates/pr/2019-07/27/TC_58ab80ea-3image_story.jpg",
        "height": 667,
        "width": 1000,
        "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=493598590174411524",
        "thumbnailHeight": 249,
        "thumbnailWidth": 373,
        "base64Encoding": null
      }
    },
    {
      "title": "<b>Taylor Swift</b> Might Actually Have A Good Album After All  Mother Jones",
      "url": "https://www.motherjones.com/media/2019/07/taylor-swift-archer-lover/",
      "description": "Her newest single is a welcome return to what made her the heartbreak queen of America.",
      "body": "Her newest single is a welcome return to what made her the heartbreak queen of America.",
      "keywords": "taylor swift,mother jones,america",
      "language": "en",
      "isSafe": true,
      "datePublished": "2019-07-26T21:54:20",
      "provider": {
        "name": "motherjones"
      },
      "image": {
        "url": "https://www.motherjones.com/wp-content/uploads/2019/07/20190423_zaf_a160_518.jpg?w=1200&h=630&crop=1",
        "height": 800,
        "width": 1200,
        "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=6308426576832310779",
        "thumbnailHeight": 200,
        "thumbnailWidth": 300,
        "base64Encoding": null
      }
    },
    {
      "title": "A first for <b>Taylor Swift</b>",
      "url": "http://www.deccanchronicle.com/entertainment/hollywood/270719/a-first-for-taylor-swift.html",
      "description": "Its a little over 10 years since <b>Taylor</b> began her music career, and on August 23, shell release her 7th studio album, Lover.",
      "body": "A first for Taylor SwiftnDECCAN CHRONICLEnJul 27, 2019, 1:07 am ISTnUpdatednJul 27, 2019, 1:07 am ISTnIts a little over 10 years since Taylor began her music career, and on August 23, shell release her 7th studio album, Lover.nTaylor SwiftnTaylor Swift has done it again. Shes won an award at the 2019 Teen Choice Awards even before the event. Reports in Eonline tell us that the Blank Space singer will receive the first-ever Icon Award at the annual award show this August.nAs one of the best-selling music artists of all time, with more than 50 million albums sold, Taylor Swift is a pop culture icon whose accolades and achievements go beyond topping music charts and selling out stadiums worldwide, read part of a statement from FOX, which will air the ceremony.nnIts a little over 10 years since Taylor began her music career, and on August 23, shell release her 7th studio album, Lover. From the album, shes already released The Archer, Me! and You Need to Calm Down, the last two of which are",
      "keywords": "taylor swift deccan chronicle,ist",
      "language": "en",
      "isSafe": true,
      "datePublished": "2019-07-26T19:37:36",
      "provider": {
        "name": "deccanchronicle"
      },
      "image": {
        "url": "https://s3.ap-southeast-1.amazonaws.com/images.deccanchronicle.com/dc-Cover-sa6bep21reqsn2lje41a37vat5-20190727010640.Medi.jpeg",
        "height": 448,
        "width": 800,
        "thumbnail": "https://contextualwebsearch.com/api/thumbnail/get?value=7421607736111190911",
        "thumbnailHeight": 224,
        "thumbnailWidth": 400,
        "base64Encoding": null
      }
    }
  ]
} 

Schema:

{
  "type": "object",
  "properties": {
    "_type": {
      "type": "string"
    },
    "didUMean": {
      "type": "string"
    },
    "totalCount": {
      "type": "integer"
    },
    "relatedSearch": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "value": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  }
}