File Exchange

image thumbnail


version (9.5 KB) by Jim Hokanson
Generalizes HTTP requests, providing more control and access to input and output


Updated 26 Mar 2012

View License

Version 1.1

Replacement for urlread. Example functions in the urlread2 file show how to make equivalent calls as are made in urlread. Helper functions can be written (some provided) to provide additional functionality without always needing to modify the urlread2 code.

Specific improvements:
- improved unicode support
- improved binary retrieval support
- request and response header access
- response status access

A technical description of the implementation can be found at:

Cite As

Jim Hokanson (2020). urlread2 (, MATLAB Central File Exchange. Retrieved .

Comments and Ratings (59)

Mehdi Javdanitehran


@Jim Hokanson, thank you for reply.
I made a mistake. "BigData/V2/wavedata/0?wavefile=G0002-2/H09/2017/23/45/52/ae623e20-9eda-4487-b403-405c26ffcb29" is url selector not body. body is set as None.

In python, the below code works. It holds connection and then i can change url selector to read different wavefiles without requesting a new connection. I am doing parallel computing, and 80 cpus are requesting wavefiles from same server. if everytime request a new connection, the server cannot handle and will time out.

con = http.client.HTTPConnection("", 5010)
while True:
con.request("GET", "/DFS/TNode/File?fileName=G0002-1/H02/2018/10/44/38/4a3cc8f1-b48f-40df-96b1-5d1e452fd63c", headers={"Connection":" keep-alive"})
result = con.getresponse()
print(result.reason, result.getheaders())

Jim Hokanson


My code doesn't support connection reuse. In general I'm not entirely sure what you are trying to accomplish.

The code does allow a body with GET, although it is very unlikely that this is correct behavior. Generally with GET all parameters are passed via the URL, as in your first example.



Hi, I tried to reuse http-connection by this tool.
I can get correct result by the following script, it behaves the save as matlab 'webread' function does.
[output,extras] = urlread2(urlChar,method,body,headersIn);

however, if i try to reuse the http connection, it fails.
[output,extras] = urlread2(urlChar,method,body,headersIn);


Jim Hokanson

@Bastian To be clear I have not made any changes to webread. It may be possible to do everything now with webread, I'm not sure. If not, what is necessary is to merge the internal Java calls of webread with my wrapping code. Reading the linked technical description above may help. Perhaps even more important is to have some knowledge of HTTP (request methods, request headers, request body, response headers, response body). If you are comfortable with Python you should be able to do what you want using Requests. I'm also briefly considered wrapping Requests in Matlab (using Matlab's Python interface), but I just don't use Matlab very much for this type of thing anymore.

Bastian Andersen

Sorry if I was unclear. I am quite familiar with Matlab, but not with any kind of online data retrieval in it and was not sure what/where you changed something. If it is a larger procedure to fix it I might try to learn how to do what I want in python instead :)

Jim Hokanson

@Bastian If you need general help using a Matlab function you should ask somewhere else (e.g., Answers, StackOverflow). Point noted that the code needs to be updated for newer security protocols and/or certificate issues. I'll take that into consideration when I get a bit of spare time to hack on something.

Bastian Andersen


I am experiencing the same problem Matt and Octavio have been discussing. I am however new to this kind of programming, so was hoping you could help me with how you fixed it by using "webread".


Jincheng Wen

Octavio Garcia

@Matt @Jim, thank you very much for the support.....for a while I feel the only person having this problem.....By now the TLS 1.2 usung the file java.opts not works, at least to me. I was doing a work around using the "fred" and "fetch" functions to go direcly to FRED (St Louis Fed). But I will try to use "webread" as Matt says. Thank you both for the great support that you do, because I am not a software geek and it is apreciate a lot!!

Jim Hokanson

@Matt, thanks for the info. It looks like the internals of the Matlab Java requests have changed quiet a bit. I'll try and incorporate the new functionality into urlread2 in the near future.


webread is the obvious solution here, Octavio. Go to to figure out how to build your url. I replaced the old 3rd party api with this one, Matlab provided function.

Thank you, Jim.


webread works, which is why I think the problem must be urlread2 which is part of the third party API ( that we have been using...will need to dig deeper into the Quandl api documentation to figure out how to replace all of the functionality of that package...just wondering if there is a newer version of urlread2 than that might make the original API function work...

Jim Hokanson

@Matt @Octavio Can you confirm whether or not the TLSV1.2 link fixed the problem now? The only other solution I can think of is to try manipulating the certificates <shudder>

If I'm given some test code I can try and debug it myself but, big picture, this solution would almost certainly require fixing something about Matlab's JRE, not my code.


I am having same problem as Octavio. I think that Quandl reverted back to old API on Sep 19 and actually just did the TLSv1.2 upgrade a couple of days ago. Is it possible that urlread2 needs to be updated to work with the new ssl protocol -- TLSv1.2?

Octavio Garcia

Thank you @Jim for the link. It is not necessary the Java update that I mention bellow to continue working with API with the transition to TLS 1.2. A poor connection to internet, or something similir related with the connection (I reproduce the problem in different computers in different sites given me the same error....and thats confuse me).

I had already used the solution that you prupose but this error randomly appear at least to me. from 21/22 to 30 of September was working fine.....yesterday and today not.....reasons??....I DONT KNOWN. My code is the same and some times works some times no.

Octavio Garcia

I am aware of the transition from the 18 of September related to TLS version 1.2 in QUANDL. I updated Matlab 2016b to the latest Java that Oracle let me,version 8 update 181 (build 1.8.0_181-b13), following the instructions below, but still not works with the latest version.

>>version -java
ans =
Java 1.8.0_181-b13 with Oracle Corporation Java HotSpot(TM) 64-Bit Server VM mixed mode

How do I change the Java Virtual Machine (JVM) that MATLAB is using on Windows? - MATLAB Answers - MATLAB Central

Response stream is undefined
below is a Java Error dump (truncated):
Error using urlread2.urlread2 (line 217)
Java exception occurred: java.lang.IllegalArgumentException: Empty key

Error in Quandl.api (line 37)
[response, extras] = urlread2.urlread2(url, 'GET', '', headers);

Error in Quandl.get (line 124)
csv = Quandl.api(path, 'params', params);

Error in zt_Usa_Data (line 54)
NYSEDATA= Quandl.get('NYXDATA/MARKET_CREDIT', 'authcode', 'FyHsP72UsMdvyks8wVsj', 'collapse',
'monthly', 'start_date', fecha_inicio);

Jim Hokanson


As indicated in the question this is most likely an error on the Matlab components side. My first guess would be to try using a newer version of Matlab (2017b or newer), as the Java version was upgraded from Java 7 to Java 8. If that doesn't work I've also recommended that people try and wrap Python's Requests library using Matlab's Python interface. If I had to redo this code again that would be the way that I would go.



Hi there - thanks for the great contribution. Urlread2 powers many of the solutionsI use on a daily basis. I have come across the following error when tryin to read/connect to specific services - i.e. to the API of ( When I use urlread2 with any of the RESTful urls, I receive the following error:

Response stream is undefined
below is a Java Error dump (truncated):
Error using urlread2 (line 217)
Java exception occurred: Received fatal alert: protocol_version

The same error arises when I use a different Matlab solution to connect to the websocket (not sure whether this is related, but I noticed the same error dump). Any idea on what issue could cause this specific connection issue to some servers (in this example Thx in advance!

fareed jamaluddin

i just find out that only the header name set as 'authorization' cannot be added . Do you have any clue on setting this up?

fareed jamaluddin

example adding four headers:
cy_header_1 = http_createHeader('date',date);
cy_header_2 = http_createHeader('X-Requested-With','XMLHttpRequest');
cy_header_3 = http_createHeader('authorization',cy_sign);
cy_header_4 = http_createHeader('accept','application/json,*/*');
header=[cy_header_1 cy_header_2 cy_header_3 cy_header_4];

[response,status] = urlread2(url,'GET',{},header);

and adding urlConnection.getRequestProperties() inside the urlread2 around line 168 it will only print the 3 common headers except the custom authorization headers.

for iHeader = 1:length(headersIn)
curHeader = headersIn(iHeader);


Jim Hokanson


Can you message me and send me example code that I can try and debug? Thanks.

fareed jamaluddin

adding urlConnection.getRequestProperties() that show all assigned headers after the for loop line 168 on assigning the headers shows that custom header does not get add to the headers. my custom header name is authorization and only header name like ( date, accept and X-Requested-With ) is modified. Please help?

Jim Hokanson


I think this is most likely a difference in supported TLS/SSL security level. Using Java 8 (Matlab 2017b) might help. Also, you should verify that whatever site you are trying to connect to works with Matlab's urlread. If it does, and doesn't work with my code then feel free to send an email to me with a site to test. If it doesn't work with Matlab's urlread then you should contact Mathworks support.

ado nunes

it does not seem to work with https, I always get the error:
Error using urlread2 (line 217)
Java exception occurred: Received fatal alert: protocol_version

Anyone knows how to solve it?

Arek Majka

I have been using this API successfully for months. It stopped working today... I am getting error:

Error using Quandl.api (line 36)
<!DOCTYPE html>
<!--[if lt IE 7]> <html class="no-js ie6 oldie" lang="en-US"> <![endif]-->
<!--[if IE 7]> <html class="no-js ie7 oldie" lang="en-US"> <![endif]-->
<!--[if IE 8]> <html class="no-js ie8 oldie" lang="en-US"> <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en-US"> <!--<![endif]-->
<title>Access denied | used CloudFlare to restrict access</title>
<meta charset="UTF-8" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1" />
<meta name="robots" content="noindex, nofollow" />
<meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1" />
<link rel="stylesheet" id="cf_styles-css" href="/cdn-cgi/styles/cf.errors.css" type="text/css" media="screen,projection" />
<!--[if lt IE 9]><link rel="stylesheet" id='cf_styles-ie-css' href="/cdn-cgi/styles/" type="text/css" media="screen,projection" /><![endif]-->
<style type="text/css">body{margin:0;padding:0}</style>
<!--[if lte IE 9]><script type="text/javascript" src="/cdn-cgi/scripts/jquery.min.js"></script><![endif]-->
<!--[if gte IE 10]><!--><script type="text/javascript" src="/cdn-cgi/scripts/zepto.min.js"></script><!--<![endif]-->
<script type="text/javascript" src="/cdn-cgi/scripts/cf.common.js"></script>

<div id="cf-wrapper">
<div class="cf-alert cf-alert-error cf-cookie-error" id="cookie-alert" data-translate="enable_cookies">Please enable cookies.</div>
<div id="cf-error-details" class="cf-error-details-wrapper">
<div class="cf-wrapper cf-header cf-error-overview">
<span class="cf-error-type" data-translate="error">Error</span>
<span class="cf-error-code">1010</span>
<small class="heading-ray-id">Ray ID: 2f0bf4c4ae045e82 &bull; 2016-10-12 16:33:53 UTC</small>
<h2 class="cf-subheadline" data-translate="error_desc">Access denied</h2>
</div><!-- /.header -->

<section></section><!-- spacer -->

<div class="cf-section cf-wrapper">
<div class="cf-columns two">
<div class="cf-column">
<h2 data-translate="what_happened">What happened?</h2>
<p>The owner of this website ( has banned your access based on your browser's signature (2f0bf4c4ae045e82-ua21).</p>

</div><!-- /.section -->

<div class="cf-error-footer cf-wrapper">
<span class="cf-footer-item">CloudFlare Ray ID: 2f0bf4c4ae045e82</span>
<span class="cf-footer-separator">&bull;</span>
<span class="cf-footer-item"><span data-translate="your_ip">Your IP</span>:</span>
<span class="cf-footer-separator">&bull;</span>
<span class="cf-footer-item"><span data-translate="performance_security_by">Performance &amp; security by</span> <a data-orig-proto="https"
data-orig-ref="" id="brand_link" target="_blank">CloudFlare</a></span>

</div><!-- /.error-footer -->

</div><!-- /#cf-error-details -->
</div><!-- /#cf-wrapper -->

<script type="text/javascript">
window._cf_translation = {};



Error in Quandl.get (line 124)
csv = Quandl.api(path, 'params', params);

What happened??

Behzad Abdollahi

how can i attach the session cookie to every request? I tried to add the cookie in the headresIn, but every time server returns a new session cookie.

thanks for the great function


Gustavo Delfino


A greatsubmission. However how would you go about passing a cookie. Several websites I need to access require a cookie to be passed along with th elogin.

Jim Hokanson

Hi José,

Sorry for the delay. Two things jump out at me.

1) Your Python example doesn't include the nonce, where as the Matlab version does
2) The headers input should be a structure array, so you want to use [] instead of {} when concatenating the header entries

header = [ struct('name','Key','value','KKKK'),...

Let me know if you have any more questions and best of luck.


José Crespo Barrios


First of all, thank you Jim for this complete function.

I have an inquiry regarding 'POST' method and the usage of a header with several fields in your function urllib2.

What I want to do it is easy to be implemented in python, but in MATLAB I am not able to do it. So I shall provide the original code in python, and then my try in MATLAB with your function. I hope I provide enough info to see where the problem is.

post_data =

sign =, post_data, hashlib.sha512).hexdigest()

headers = {
'Sign': sign,
'Key': self.APIKey

ret = urllib2.urlopen(urllib2.Request('', post_data, headers))

My try in MATLAB:
body =;

header = { struct('name','Key','value','KKKK'),...

urlbase = ''

json = urlread2(urlbase,'POST',body,header);

Thank you in advance and kind regards


Maxwell Agnew

I'm trying to use urlread2 to make a post request to the Etrade API. Their documentation says:

"Since this is a POST request, the parameters are included in the request as XML or JSON"

Can urlread2 handle a 'POST' request with the xml? An example would be much appreciated.



Jim Hokanson


My apologies on PATCH not working. This is a problem with the underlying Java classes. I'll try to look into alternative Java classes.




http DELETE method works OK:

url ='';
header = http_createHeader('Authorization','Bearer XXXXXXXX-YYYYYYYYY');


ans =

"id" : 619104742,
"instrument" : "EUR_GBP",
"units" : 1,
"side" : "buy",
"price" : 0.79643,
"time" : "2014-07-22T03:25:49.000000Z",
"type" : "BuyEntry"



Thanks for your answer.

I get this error message when I use the PATCH method here:
header = http_createHeader('Authorization','XXXXXXXX-YYYYYYYYY');
params = {'units' '2'};
uparams = http_paramsToString(params);
url ='';
Error using urlread2 (line 157)
Java exception occurred: Invalid HTTP method: PATCH

at Source)

at Source)

What do you think is causing it?


Jim Hokanson


Yes, both are. I've exposed the entirety of the HTTP request and response so you can do anything you want with it.



Hello. Thanks for your Help. Are http PATCH and DELETE methods supported? Thanks

Jim Hokanson


My apologies on the confusing documentation. When providing headers you also need to provide the body so that the order of the inputs is maintained. In this case providing an empty body is fine.

urlread2 (url,'GET','',header)

One day I'd like to rewrite this code base so that this is unnecessary and clearer ...

Best of luck and let me know if you have any other questions.




I'm a newbie in MATLAB, I want to use MATLAB send http GET, POST, PATCH and DELETE commands to a REST API:

for identification a header has to be sent in this format:

So I type:
header = http_createHeader('Authorization','Bearer XXXXXXXX-YYYYYYYYY')

url = ''

urlread2 (url,'GET',header)

and I get this message:
Error using urlread2 (line 180)
Function input: body, should be of class char, uint8, or int8, detected: struct

Is this a problem with the header?



Jim Hokanson


Usually problems arise due to the site using javascript. To get around this I'll usually use a program called "Fiddler" (In Windows). I'll go to the site in my web browser and then look at Fiddler to see what requests are being made to the server. Look for a request and subsequent response from the site that contains the information that you want. Then look more closely at the request to see how you would make the same request.

Best of luck.



Thought that URLREAD2 would alleviate the issues I have using URLREAD to retrieve the contents of a URL page.
y = urlread( '');

Would like to extract information from the page (e.g. price). While I can see all the info in the source page (in the browser), there is no info in the return value from URLREAD2. Is the server somehow trying to protect the info? Anything that could be done?

Thanks a lot.

none poncho

Perfect solution for one of matlab's problems, but i'm experiencing difficulties in using it. I'm trying to upload binary contents. Can you please provide an example?

Cary Belas

Perfectly solved my quesionts


This function solved my long waiting time of the java call findproxyforurl. Thank you!


Very helpful, thanks! This gave me exactly what I needed.


Thanks, I like it. I only wanted to see what my web-server was sending in a Header, and did the trick nicely. I am more comfortable with MATLAB than web scripting, so this was the easiest solution for me. With regard to my rating though, please bear in mind that I did not take it for a thorough test drive..


Thanks for your availability. I'll wait for your example, maybe I can figure out better what you are suggesting.

Jim Hokanson

Ah, that clarifies things a bit. That brings up a tricky issue. Your use case isn't necessarily envisioned by their server and you might be blocked temporarily. To minimize this possibility you can space out your queries in time, perhaps every 10 - 20 seconds. I've run into this case with Google Scholar where eventually they poppped up a Captcha to try and prevent me from making automatic queries. It is a bit frustrating that they don't provide a code interface which would minimize their server load while still allowing access to users.

It looks like you are making a GET request, which means that all of the parameters are attached to the URL during the request. I've described this briefly in:
Essentially the way to do what you are asking is to make an example request in your browser where you change the date ranges, see how those dates are placed into the request url. Then you learn to modify the request url appropriately. I have code which would help with this but it is not included in this package. I can work on including it. Basically the code first splits on '&' characters to get [property]=[value] pairs. Then you split on '=' to separate the property from the value. Then you want to take each property and value and decode them using the function urldecode. Once this is done it should be pretty obvious where your dates are in the request. You then just modify those dates, repackage all of the parameters, and add them onto the original url after the '?' symbol.

I'll try and post an example of this with new code by the end of the week.


Sorry, I forgot to tell you the most important thing. I meant, the search on Google News. Now it should be clear.

Jim Hokanson

When you mention different time intervals I assume you mean running the function multiple times over the course of many hours/days/weeks etc. If that is the case these links might be helpful:


I used this function and I realized that in the output there's what I need, that is, the number of results of a search. Is it possibile to collect it automatically for different time intervals?

Jim Hokanson

Doubtful, that error is coming because some router or Google server is blocking your ip address (like if you are using a computer in China). You would need to use a proxy to get around that. The fix I just uploaded may provide a more explicit error message than what it was previously giving you, but it should be just the same as if you entered that url in a browser. Note: with the fix the error message will be the output (instead of throwing an error), and the extras structure will have a status indicating that the error occurred and that the output is an error message.

Shane Lin

Do you think if it will work if I add "urlConnection.setFollowRedirects(1);" to urlread? Thanks

Jim Hokanson

Well that stinks. It works for me. There are two issues going on here.
1) The example should work, I'll find a better one!
2) I made some last minute changes to try and directly handle errors instead of letting them cause code errors further down in the code which were harder to debug. What I didn't realize was that the handler recognizes HTTP status codes and processes them as errors as well. In other words, I thought the 403 error code you are seeing would go through just fine and that you would need to check the status and the output to see that something was wrong.
I'll address these changes and upload a new version ASAP.


Shane Lin

Just tested the get example:

??? Error using ==> urlread2 at 203
Java exception occurred: Server returned HTTP response code: 403 for URL:


Changed description

Fixed GET example and code now returns HTTP status codes that are errors along with the error text instead of just throwing an error.

MATLAB Release Compatibility
Created with R2011b
Compatible with any release
Platform Compatibility
Windows macOS Linux