The Mediastack news API supports any client and server-side programming language. We have prepared code examples for the languages PHP, Python, jQuery, Go and Ruby.

Code Example - PHP

$queryString = http_build_query([\n  'access_key' => 'ACCESS_KEY',\n  'keywords' => 'Wall street -wolf', // the word \"wolf\" will be\n  'categories' => '-entertainment',\n  'sort' => 'popularity',\n]);\n\n$ch = curl_init(sprintf('%s?%s', 'https://api.mediastack.com/v1/news', $queryString));\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\n\n$json = curl_exec($ch);\n\ncurl_close($ch);\n\n$apiResult = json_decode($json, true);\n\nprint_r($apiResult);

Code Example - Python

# Python 3\nimport http.client, urllib.parse\n\nconn = http.client.HTTPConnection('api.mediastack.com')\n\nparams = urllib.parse.urlencode({\n    'access_key': 'ACCESS_KEY',\n    'categories': '-general,-sports',\n    'sort': 'published_desc',\n    'limit': 10,\n    })\n\nconn.request('GET', '/v1/news?{}'.format(params))\n\nres = conn.getresponse()\ndata = res.read()\n\nprint(data.decode('utf-8'))

Code Example - jQuery

$.ajax({\n    url: 'https://api.mediastack.com/v1/news',\n    data: {\n      access_key: 'ACCESS_KEY',\n      languages: 'fr,-en',\n      countries: 'ca,fr',\n      limit: 30,\n      offset: 30,\n    }\n  }).done(function(data) {\n    console.log(JSON.parse(data));\n});

Code Example - Go

package main\n\nimport (\n\t\"fmt\"\n\t\"io/ioutil\"\n\t\"net/http\"\n\t\"net/url\"\n)\n\nfunc main() {\n\tbaseURL, _ := url.Parse(\"https://api.mediastack.com\")\n\n\tbaseURL.Path += \"v1/news\"\n\n\tparams := url.Values{}\n\t// Access Key\n\tparams.Add(\"access_key\", \"ACCESS_KEY\")\n\t// Parameters\n\tparams.Add(\"sources\", \"cnn,bbc\")\n\tparams.Add(\"categories\", \"sports,general\")\n\tparams.Add(\"languages\", \"-en\") // It will exclude english results\n\n\tbaseURL.RawQuery = params.Encode()\n\n\treq, _ := http.NewRequest(\"GET\", baseURL.String(), nil)\n\n\tres, _ := http.DefaultClient.Do(req)\n\n\tdefer res.Body.Close()\n\n\tbody, _ := ioutil.ReadAll(res.Body)\n\n\tfmt.Println(string(body))\n}

Code Example - Ruby

require 'uri'\nrequire 'net/http'\n\nuri = URI('https://api.mediastack.com/v1/news')\n\nparams = {\n    'access_key' => 'ACCESS_KEY',\n    'keywords' => 'Wall street -wolf',\n    'categories' => '-entertainment',\n    'sort' => 'popularity',\n}\n\nuri.query = URI.encode_www_form(params)\n\nresponse = Net::HTTP.get_response(uri)\n\nputs response.read_body

\n\n

\n\n\n\n \n Questions? \n \n Contact Sales\n .\n\n

\n\n\n\n \n Need help? \n \n Contact Support\n .\n\n

\n\n \n\n \n

","contentUpdatedAt","Fri, 07 Nov 2025 13:35:21 GMT","generatorLanguages","SHUBApiDetails","exploreUrl","currentToc",{"_71":406,"_407":434,"_401":435,"_410":436,"_157":512},[],"shubUrl","apiRenderer","TOGGLE","routingSettings",{"_518":519,"_520":17},"routing","browser","credentialsEnabled","isTemplatePreview","metaInfo",{"_524":525,"_194":195,"_401":526},"canonicalUrl","https://docs.apilayer.com/mediastack/docs/code-examples","Code Examples | Mediastack | APILayer ","actionData","errors"]