Get the API Key (no credit card required) from our RapidAPI page
\nHome page of nuntium.dev
\nPowered by GDELT
\nMillions of news articles are published online every week. Each article mentions people and organizations.
\nWe host an API that lets you extract aggregated statistics on any entity. Whether it is an organization or a person, our engine will scan millions of news articles and return the aggregated statistics within a second.
\nWe heavily rely on GDELT data. Though, we built our own data infrastructure that helps us transform and store GDELT data in a unique manner. As a result, you can aggregate and derive complex queries that return the result within milliseconds while going through millions of data records.
\nExtracts from gdeltproject.org:
\n\"GDELT monitors the world's news media from nearly every corner of every country in print, broadcast, and web formats, in over 100 languages, every moment of every day.\"
\nlang parameters from the first column, pass all lowercase
Returns the last 24 hours top 100 on org/person/source
\nGet the top 100 most mentioned organization or person in media for the past 24 hours.
\nData updated every 15 minutes.
\nUse this endpoint to get the top 100 entities mentioned in online articles.
\nWe return:
\nrank - rank from 1 to 100name - the name of an entityarticles - how many articles mention the entity from name fieldREQUIRED
\ntype must be one of:
\nOPTIONAL
\nSTRING
\nCheck the language table for possible values
\n","type":"text/plain"},"key":"lang","value":"all"},{"disabled":true,"key":"","value":""}],"variable":[]}},"response":[{"id":"ba156c1e-34c0-4e81-b0f8-a89bfc0739cb","name":"/top","originalRequest":{"method":"GET","header":[{"key":"x-rapidapi-key","value":"{YOUR_API_KEY}","type":"text"}],"url":{"raw":"https://nuntium.p.rapidapi.com/v0/top?type=organization&lang=all","protocol":"https","host":["nuntium","p","rapidapi","com"],"path":["v0","top"],"query":[{"key":"type","value":"organization","description":"**REQUIRED** \n___\ntype must be one of:\n* __person__,\n* __organization__\n* __publisher__"},{"key":"lang","value":"all","description":"**OPTIONAL**\n___\nISO-something type"},{"key":"","value":"","type":"text","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Wed, 22 Apr 2020 07:29:04 GMT"},{"key":"Server","value":"RapidAPI-1.1.0"},{"key":"Via","value":"1.1 160bb0630905c94d984edd48c570887e.cloudfront.net (CloudFront)"},{"key":"x-amz-apigw-id","value":"LYLKHE6ZIAMFTUQ="},{"key":"X-Amz-Cf-Id","value":"Tl3K_3_euPHxU7CPL8OH6NVqV8wOB6MN1YADD5jesxEo6eg0X7GEeA=="},{"key":"X-Amz-Cf-Pop","value":"SIN2-C1"},{"key":"x-amzn-RequestId","value":"1144f9a2-64ab-4bd6-a765-766954cf6bad"},{"key":"X-Amzn-Trace-Id","value":"Root=1-5e9ff240-825917588c64847c4d05d32c;Sampled=0"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"X-RapidAPI-Region","value":"AWS - ap-southeast-1"},{"key":"X-RapidAPI-Version","value":"1.1.0"},{"key":"Content-Length","value":"5386"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"lang\": \"all\",\n \"type\": \"organization\",\n \"range\": \"24h\",\n \"result\": [\n {\n \"name\": \"united states\",\n \"articles\": 37914,\n \"rank\": 1\n },\n {\n \"name\": \"facebook\",\n \"articles\": 14542,\n \"rank\": 2\n },\n {\n \"name\": \"twitter\",\n \"articles\": 13271,\n \"rank\": 3\n },\n {\n \"name\": \"white house\",\n \"articles\": 11303,\n \"rank\": 4\n },\n {\n \"name\": \"reuters\",\n \"articles\": 11009,\n \"rank\": 5\n },\n {\n \"name\": \"cnn\",\n \"articles\": 9413,\n \"rank\": 6\n },\n {\n \"name\": \"instagram\",\n \"articles\": 9189,\n \"rank\": 7\n },\n {\n \"name\": \"world health organization\",\n \"articles\": 6814,\n \"rank\": 8\n },\n {\n \"name\": \"associated press\",\n \"articles\": 6723,\n \"rank\": 9\n },\n {\n \"name\": \"young\",\n \"articles\": 4086,\n \"rank\": 10\n },\n {\n \"name\": \"youtube\",\n \"articles\": 4052,\n \"rank\": 11\n },\n {\n \"name\": \"paycheck protection program\",\n \"articles\": 3901,\n \"rank\": 12\n },\n {\n \"name\": \"supreme court\",\n \"articles\": 3219,\n \"rank\": 13\n },\n {\n \"name\": \"ministry of health\",\n \"articles\": 3208,\n \"rank\": 14\n },\n {\n \"name\": \"netflix\",\n \"articles\": 3014,\n \"rank\": 15\n },\n {\n \"name\": \"google\",\n \"articles\": 2957,\n \"rank\": 16\n },\n {\n \"name\": \"united nations\",\n \"articles\": 2894,\n \"rank\": 17\n },\n {\n \"name\": \"johns hopkins university\",\n \"articles\": 2797,\n \"rank\": 18\n },\n {\n \"name\": \"department of health\",\n \"articles\": 2713,\n \"rank\": 19\n },\n {\n \"name\": \"centers for disease\",\n \"articles\": 2422,\n \"rank\": 20\n },\n {\n \"name\": \"express\",\n \"articles\": 2329,\n \"rank\": 21\n },\n {\n \"name\": \"thomson reuters trust principles\",\n \"articles\": 2195,\n \"rank\": 22\n },\n {\n \"name\": \"nasdaq\",\n \"articles\": 2152,\n \"rank\": 23\n },\n {\n \"name\": \"european union\",\n \"articles\": 2111,\n \"rank\": 24\n },\n {\n \"name\": \"public health\",\n \"articles\": 2075,\n \"rank\": 25\n },\n {\n \"name\": \"drug administration\",\n \"articles\": 2065,\n \"rank\": 26\n },\n {\n \"name\": \"new york times\",\n \"articles\": 2002,\n \"rank\": 27\n },\n {\n \"name\": \"bloomberg\",\n \"articles\": 1981,\n \"rank\": 28\n },\n {\n \"name\": \"disney\",\n \"articles\": 1906,\n \"rank\": 29\n },\n {\n \"name\": \"ministry health\",\n \"articles\": 1773,\n \"rank\": 30\n },\n {\n \"name\": \"espn\",\n \"articles\": 1659,\n \"rank\": 31\n },\n {\n \"name\": \"boeing\",\n \"articles\": 1544,\n \"rank\": 32\n },\n {\n \"name\": \"european commission\",\n \"articles\": 1492,\n \"rank\": 33\n },\n {\n \"name\": \"union european\",\n \"articles\": 1484,\n \"rank\": 34\n },\n {\n \"name\": \"national assembly\",\n \"articles\": 1477,\n \"rank\": 35\n },\n {\n \"name\": \"high school\",\n \"articles\": 1435,\n \"rank\": 36\n },\n {\n \"name\": \"champions league\",\n \"articles\": 1401,\n \"rank\": 37\n },\n {\n \"name\": \"junior\",\n \"articles\": 1352,\n \"rank\": 38\n },\n {\n \"name\": \"xinhua\",\n \"articles\": 1308,\n \"rank\": 39\n },\n {\n \"name\": \"warner bros\",\n \"articles\": 1302,\n \"rank\": 40\n },\n {\n \"name\": \"microsoft\",\n \"articles\": 1291,\n \"rank\": 41\n },\n {\n \"name\": \"linkedin\",\n \"articles\": 1282,\n \"rank\": 42\n },\n {\n \"name\": \"senate minority leader chuck schumer\",\n \"articles\": 1258,\n \"rank\": 43\n },\n {\n \"name\": \"health ministry\",\n \"articles\": 1247,\n \"rank\": 44\n },\n {\n \"name\": \"ministry to health\",\n \"articles\": 1228,\n \"rank\": 45\n },\n {\n \"name\": \"central bank\",\n \"articles\": 1222,\n \"rank\": 46\n },\n {\n \"name\": \"international monetary fund\",\n \"articles\": 1179,\n \"rank\": 47\n },\n {\n \"name\": \"world health organisation\",\n \"articles\": 1176,\n \"rank\": 48\n },\n {\n \"name\": \"human services\",\n \"articles\": 1147,\n \"rank\": 49\n },\n {\n \"name\": \"central committee\",\n \"articles\": 1135,\n \"rank\": 50\n },\n {\n \"name\": \"small business administration\",\n \"articles\": 1120,\n \"rank\": 51\n },\n {\n \"name\": \"olympics\",\n \"articles\": 1114,\n \"rank\": 52\n },\n {\n \"name\": \"exchange commission\",\n \"articles\": 1072,\n \"rank\": 53\n },\n {\n \"name\": \"huawei\",\n \"articles\": 977,\n \"rank\": 54\n },\n {\n \"name\": \"scripps national spelling bee\",\n \"articles\": 966,\n \"rank\": 55\n },\n {\n \"name\": \"bmw\",\n \"articles\": 953,\n \"rank\": 56\n },\n {\n \"name\": \"samsung\",\n \"articles\": 946,\n \"rank\": 57\n },\n {\n \"name\": \"office for national statistics\",\n \"articles\": 941,\n \"rank\": 58\n },\n {\n \"name\": \"xinhua news agency\",\n \"articles\": 910,\n \"rank\": 59\n },\n {\n \"name\": \"senate majority leader mitch mcconnell\",\n \"articles\": 903,\n \"rank\": 60\n },\n {\n \"name\": \"national sovereignty\",\n \"articles\": 897,\n \"rank\": 61\n },\n {\n \"name\": \"america food fund\",\n \"articles\": 894,\n \"rank\": 62\n },\n {\n \"name\": \"media group ltd\",\n \"articles\": 886,\n \"rank\": 63\n },\n {\n \"name\": \"russian federation\",\n \"articles\": 871,\n \"rank\": 64\n },\n {\n \"name\": \"national guard\",\n \"articles\": 844,\n \"rank\": 65\n },\n {\n \"name\": \"world bank\",\n \"articles\": 843,\n \"rank\": 66\n },\n {\n \"name\": \"department of homeland security\",\n \"articles\": 830,\n \"rank\": 67\n },\n {\n \"name\": \"organization world\",\n \"articles\": 826,\n \"rank\": 68\n },\n {\n \"name\": \"public service\",\n \"articles\": 811,\n \"rank\": 69\n },\n {\n \"name\": \"alcoa\",\n \"articles\": 797,\n \"rank\": 70\n },\n {\n \"name\": \"harvard university\",\n \"articles\": 784,\n \"rank\": 71\n },\n {\n \"name\": \"major league baseball\",\n \"articles\": 781,\n \"rank\": 72\n },\n {\n \"name\": \"city council\",\n \"articles\": 777,\n \"rank\": 73\n },\n {\n \"name\": \"msnbc\",\n \"articles\": 769,\n \"rank\": 74\n },\n {\n \"name\": \"foundation barn food indonesia\",\n \"articles\": 765,\n \"rank\": 75\n },\n {\n \"name\": \"senate on\",\n \"articles\": 761,\n \"rank\": 76\n },\n {\n \"name\": \"health department\",\n \"articles\": 752,\n \"rank\": 77\n },\n {\n \"name\": \"national institutes of health\",\n \"articles\": 744,\n \"rank\": 78\n },\n {\n \"name\": \"council of ministers\",\n \"articles\": 727,\n \"rank\": 79\n },\n {\n \"name\": \"toyota\",\n \"articles\": 714,\n \"rank\": 80\n },\n {\n \"name\": \"department of defense\",\n \"articles\": 713,\n \"rank\": 81\n },\n {\n \"name\": \"federal reserve\",\n \"articles\": 711,\n \"rank\": 82\n },\n {\n \"name\": \"assembly national\",\n \"articles\": 710,\n \"rank\": 83\n },\n {\n \"name\": \"walmart\",\n \"articles\": 692,\n \"rank\": 84\n },\n {\n \"name\": \"robert koch institute\",\n \"articles\": 686,\n \"rank\": 85\n },\n {\n \"name\": \"prosecutor office\",\n \"articles\": 681,\n \"rank\": 86\n },\n {\n \"name\": \"senate democratic leader chuck schumer\",\n \"articles\": 681,\n \"rank\": 87\n },\n {\n \"name\": \"democratic party\",\n \"articles\": 676,\n \"rank\": 88\n },\n {\n \"name\": \"office information\",\n \"articles\": 668,\n \"rank\": 89\n },\n {\n \"name\": \"corus entertainment inc\",\n \"articles\": 663,\n \"rank\": 90\n },\n {\n \"name\": \"high court\",\n \"articles\": 662,\n \"rank\": 91\n },\n {\n \"name\": \"citic\",\n \"articles\": 652,\n \"rank\": 92\n },\n {\n \"name\": \"oxford university\",\n \"articles\": 646,\n \"rank\": 93\n },\n {\n \"name\": \"office health\",\n \"articles\": 638,\n \"rank\": 94\n },\n {\n \"name\": \"mcdonald\",\n \"articles\": 637,\n \"rank\": 95\n },\n {\n \"name\": \"research center\",\n \"articles\": 637,\n \"rank\": 96\n },\n {\n \"name\": \"court constitutional\",\n \"articles\": 635,\n \"rank\": 97\n },\n {\n \"name\": \"company shares technology responsible address stories students\",\n \"articles\": 626,\n \"rank\": 98\n },\n {\n \"name\": \"health care enhancement\",\n \"articles\": 626,\n \"rank\": 99\n },\n {\n \"name\": \"philippe\",\n \"articles\": 621,\n \"rank\": 100\n }\n ]\n}"}],"_postman_id":"940e9102-30a4-4e4b-bfe5-9649e98f8bce"}],"id":"e6404bc9-65d6-4f9e-85be-f07103260bc2","description":"/top endpoint returns top 100 persons, organizations or publishers for the past 24 hours
Get the count and average tone of all articles that were published online over the past 7 days (up to 30) by any publisher of search.
Data is updated every 15 minutes.
\nAPI returns:
\ndate - DateTimearticles - how many articles mention the searched organizationavg_tone - average tone of all articles for this dayREQUIRED
\nSTRING
\nbase form URL of the publisher
\n","type":"text/plain"},"key":"name","value":"nytimes.com"},{"description":{"content":"OPTIONAL
\nINTEGER
\nHow many latest days of data to return.
\nFrom 1 to 30
\n","type":"text/plain"},"key":"range","value":"7"},{"description":{"content":"OPTIONAL
\nSTRING
\nCheck the language table for possible values
\n","type":"text/plain"},"key":"lang","value":"all"},{"description":{"content":"BOOLEAN
\nIf true returns top 5 mentioned organization for each day
BOOLEAN
\nIf true returns top 5 mentioned person for each day
/publisher endpoint returns main statistics for any online news website. For example, nytimes.com, theverge.com, wsj.com, etc.
REQUIRED
\nSTRING
\nname of the comany/organization
\nall lowercase
\n","type":"text/plain"},"key":"name","value":"apple inc"},{"description":{"content":"OPTIONAL
\nINTEGER
\nHow many latest days of data to return.
\nFrom 1 to 30
\n","type":"text/plain"},"key":"range","value":"7"},{"description":{"content":"OPTIONAL
\nSTRING
\nCheck the language table for possible values
\n","type":"text/plain"},"key":"lang","value":"all"}],"variable":[]}},"response":[{"id":"1c92cb36-5203-456f-b956-0ebf21bef600","name":"/organization","originalRequest":{"method":"GET","header":[{"key":"x-rapidapi-key","value":"{YOUR_API_KEY}","type":"text"}],"url":{"raw":"https://nuntium.p.rapidapi.com/v0/organization?name=apple inc&range=7&lang=all","protocol":"https","host":["nuntium","p","rapidapi","com"],"path":["v0","organization"],"query":[{"key":"name","value":"apple inc"},{"key":"range","value":"7"},{"key":"lang","value":"all"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Wed, 22 Apr 2020 07:54:45 GMT"},{"key":"Server","value":"RapidAPI-1.1.0"},{"key":"Via","value":"1.1 46dd9ae2d97161deaefbdceeae5f57ac.cloudfront.net (CloudFront)"},{"key":"x-amz-apigw-id","value":"LYO6hEZ5oAMFpMA="},{"key":"X-Amz-Cf-Id","value":"SoWr7lrt3UqZZFNQC1WQGYGLIh32_KGsvc3mgF5ULKWnBCDI2I69ZQ=="},{"key":"X-Amz-Cf-Pop","value":"SIN2-C1"},{"key":"x-amzn-RequestId","value":"830929af-affa-4478-9d94-edd4ec2337ad"},{"key":"X-Amzn-Trace-Id","value":"Root=1-5e9ff843-b9eec29666dcf142270488b8;Sampled=0"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"X-RapidAPI-Region","value":"AWS - ap-southeast-1"},{"key":"X-RapidAPI-Version","value":"1.1.0"},{"key":"Content-Length","value":"665"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"apple inc\",\n \"lang\": \"all\",\n \"range\": \"7d\",\n \"result\": [\n {\n \"date\": \"2020-04-22 00:00:00\",\n \"articles\": 16,\n \"avg_tone\": 0.3963907644152641\n },\n {\n \"date\": \"2020-04-21 00:00:00\",\n \"articles\": 109,\n \"avg_tone\": -4.0497563282648725\n },\n {\n \"date\": \"2020-04-20 00:00:00\",\n \"articles\": 75,\n \"avg_tone\": -1.2772528954914637\n },\n {\n \"date\": \"2020-04-19 00:00:00\",\n \"articles\": 16,\n \"avg_tone\": -0.8404368460178375\n },\n {\n \"date\": \"2020-04-18 00:00:00\",\n \"articles\": 81,\n \"avg_tone\": -2.479748749732971\n },\n {\n \"date\": \"2020-04-17 00:00:00\",\n \"articles\": 194,\n \"avg_tone\": -1.3910984133972841\n },\n {\n \"date\": \"2020-04-16 00:00:00\",\n \"articles\": 211,\n \"avg_tone\": -2.113058179616928\n },\n {\n \"date\": \"2020-04-15 00:00:00\",\n \"articles\": 196,\n \"avg_tone\": -1.617293112657287\n }\n ]\n}"}],"_postman_id":"276e6614-815a-4bd8-b036-a5a2cffb00ed"}],"id":"674c3586-b7bd-47ff-b555-62704b87f35e","event":[{"listen":"prerequest","script":{"id":"53ca6da5-fd35-477d-a53b-00e40fe352d4","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"a0777fde-7a42-4494-868c-93309dc7d2e5","type":"text/javascript","exec":[""]}}],"_postman_id":"674c3586-b7bd-47ff-b555-62704b87f35e","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":""},{"key":"value","value":"REQUIRED
\nSTRING
\nname of the person
\nall lowercase
\n","type":"text/plain"},"key":"name","value":"bill gates"},{"description":{"content":"OPTIONAL
\nINTEGER
\nHow many latest days of data to return.
\nFrom 1 to 30
\n","type":"text/plain"},"key":"range","value":"7"},{"description":{"content":"OPTIONAL
\nSTRING
\nCheck the language table for possible values
\n","type":"text/plain"},"key":"lang","value":"all"}],"variable":[]}},"response":[{"id":"779af007-a655-4965-b5aa-00e87ad42205","name":"/person","originalRequest":{"method":"GET","header":[{"key":"x-rapidapi-key","value":"{YOUR_API_KEY}","type":"text"}],"url":{"raw":"https://nuntium.p.rapidapi.com/v0/person?name=bill gates&range=7&lang=all","protocol":"https","host":["nuntium","p","rapidapi","com"],"path":["v0","person"],"query":[{"key":"name","value":"bill gates"},{"key":"range","value":"7"},{"key":"lang","value":"all"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Wed, 22 Apr 2020 07:55:03 GMT"},{"key":"Server","value":"RapidAPI-1.1.0"},{"key":"Via","value":"1.1 d103b7ce7f019a66fa1afbceb8b1f1c1.cloudfront.net (CloudFront)"},{"key":"x-amz-apigw-id","value":"LYO9YEP5IAMF7xw="},{"key":"X-Amz-Cf-Id","value":"9qbZ8giYXzUZc06I1nfOyY5Nce4hMIBZ7HSUkX_2dz65tYBl4PIZew=="},{"key":"X-Amz-Cf-Pop","value":"SIN2-C1"},{"key":"x-amzn-RequestId","value":"f8c2d56b-5b33-4827-828c-d250810c3ad7"},{"key":"X-Amzn-Trace-Id","value":"Root=1-5e9ff855-4e122eb41237c17afd58b862;Sampled=0"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"X-RapidAPI-Region","value":"AWS - ap-southeast-1"},{"key":"X-RapidAPI-Version","value":"1.1.0"},{"key":"Content-Length","value":"670"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"name\": \"bill gates\",\n \"lang\": \"all\",\n \"range\": \"7d\",\n \"result\": [\n {\n \"date\": \"2020-04-22 00:00:00\",\n \"articles\": 114,\n \"avg_tone\": -4.557648134231568\n },\n {\n \"date\": \"2020-04-21 00:00:00\",\n \"articles\": 357,\n \"avg_tone\": -4.124470365674872\n },\n {\n \"date\": \"2020-04-20 00:00:00\",\n \"articles\": 287,\n \"avg_tone\": -3.3460718284953725\n },\n {\n \"date\": \"2020-04-19 00:00:00\",\n \"articles\": 282,\n \"avg_tone\": 0.5606743264943361\n },\n {\n \"date\": \"2020-04-18 00:00:00\",\n \"articles\": 239,\n \"avg_tone\": -2.3474912732839583\n },\n {\n \"date\": \"2020-04-17 00:00:00\",\n \"articles\": 553,\n \"avg_tone\": -6.034457690473916\n },\n {\n \"date\": \"2020-04-16 00:00:00\",\n \"articles\": 840,\n \"avg_tone\": -3.0081900833174586\n },\n {\n \"date\": \"2020-04-15 00:00:00\",\n \"articles\": 1213,\n \"avg_tone\": -3.462528400733823\n }\n ]\n}"}],"_postman_id":"faabccfd-9214-4615-bfa4-6183df8feeae"}],"id":"9bd164d7-46fd-49af-b837-a22f6ccba7ff","event":[{"listen":"prerequest","script":{"id":"41146144-7c27-4a69-b8b0-35f1e1a65657","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"05fd78db-2a62-413b-a4cd-a7d6e51b4d4d","type":"text/javascript","exec":[""]}}],"_postman_id":"9bd164d7-46fd-49af-b837-a22f6ccba7ff","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":""},{"key":"value","value":"