CINXE.COM

<!DOCTYPE html><html lang="en"><head><link rel="shortcut icon" href="/content/wm_favicon.ico"><meta charset="utf-8"><meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1"><link href="/styles/theme.css" rel="stylesheet" type="text/css"><script src="/scripts/theme.js" type="text/javascript"></script><title>Wood Mackenzie API Portal - FAQ - Microsoft Azure API Management - developer portal</title><meta name="description" content="(guests view) Similar to the FAQ page, except that for guest users, links to user profile, APIs list, API Usage Analytics will take users to the login warning page."><meta name="keywords" content="Azure, API Management, API, developer"><meta name="author" content="Microsoft Azure API Management"><link href="/styles/styles.css" rel="stylesheet" type="text/css"><meta property="og:type" content="article"><meta property="og:site_name" content="Microsoft Azure API Management - developer portal"><meta property="og:title" content="Wood Mackenzie API Portal - FAQ"><meta property="og:description" content="(guests view) Similar to the FAQ page, except that for guest users, links to user profile, APIs list, API Usage Analytics will take users to the login warning page."><meta property="og:url" content="/quests-faq"><link href="/quests-faq/styles.css" rel="stylesheet" type="text/css"></head><body class="block"><div class="flex flex-column flex-grow fill"><div class="popup-host"></div><section class="yducimamxb yducimamxb-sm yducimamxb-md yducimamxb-lg yducimamxb-xl" access-id="dbb641de-4582-64b5-0bd3-e84ac8b57182"><div class="gjpnqnxbbj gjpnqnxbbj-sm gjpnqnxbbj-md gjpnqnxbbj-lg gjpnqnxbbj-xl"><div class="kltazpmqso kltazpmqso-sm kltazpmqso-xl kltazpmqso-md" role="article"><a href="/"><img class="content picture picture-nhebn" src="/content/WMlogo-title.png" alt="Picture" width="400" style="width:400px;height:55px" height="55"></a><div class="collapsible collapsible-panel legacy"><div class="collapsible-backdrop"></div><div class="collapsible-content rqgdafxoox-md rqgdafxoox-lg rqgdafxoox-xl rqgdafxoox rqgdafxoox-sm"><nav access-id="d4fa2d3a-172d-c01d-0546-da8de262ba03" class="menu menu-r8rew inline-block"><div class="menu menu-horizontal"><ul class="nav"><li class="nav-item"><a href="/" class="nav-link" data-bind="text: item.label, hyperlink: item.hyperlink, css: { 'nav-link-active': item.isActive }">HOME</a></li><li class="nav-item"><a href="#" class="nav-link" data-toggle="dropdown" data-bind="text: item.label, hyperlink: item.hyperlink, css: { 'nav-link-active': item.isActive }">HOW TO</a><div class="dropdown"><ul class="nav"><li class="nav-item"><a href="/get-started" class="nav-link" data-bind="text: item.label, hyperlink: item.hyperlink, css: { 'nav-link-active': item.isActive }" target="_self">GET STARTED</a></li><li class="nav-item"><a href="/basics" class="nav-link" data-bind="text: item.label, hyperlink: item.hyperlink, css: { 'nav-link-active': item.isActive }" target="_self">THE BASICS</a></li><li class="nav-item"><a href="/import-data-into-excel" class="nav-link" data-bind="text: item.label, hyperlink: item.hyperlink, css: { 'nav-link-active': item.isActive }" target="_self">IMPORT DATA INTO EXCEL</a></li><li class="nav-item"><a href="/query-data-in-bulk" class="nav-link" data-bind="text: item.label, hyperlink: item.hyperlink, css: { 'nav-link-active': item.isActive }" target="_self">QUERY DATA IN BULK</a></li></ul></div></li></ul></div></nav><nav access-id="b5f2c8b8-0917-14d2-27ad-83c1fdb5139e" class="menu menu-r8rew inline-block"><div class="menu menu-horizontal"><ul class="nav"><li class="nav-item"><a href="/guests-overview" class="nav-link" data-bind="text: item.label, hyperlink: item.hyperlink, css: { 'nav-link-active': item.isActive }" target="_self">OVERVIEW</a></li><li class="nav-item"><a href="/quests-faq" class="nav-link nav-link-active" data-bind="text: item.label, hyperlink: item.hyperlink, css: { 'nav-link-active': item.isActive }" target="_self">FAQ</a></li><li class="nav-item"><a href="/signin?" class="nav-link" data-bind="text: item.label, hyperlink: item.hyperlink, css: { 'nav-link-active': item.isActive }" target="_self">SIGN IN</a></li></ul></div></nav><button class="collapsible-panel-close" aria-label="Toggle" data-dismiss="collapsible"><i class="icon-emb icon-emb-simple-remove"></i></button></div><button class="collapsible-panel-open" aria-label="Toggle" data-toggle="collapsible"><i class="icon-emb icon-emb-menu-8"></i></button></div></div></div></section><section class="nfsmvqtubj nfsmvqtubj-sm nfsmvqtubj-md nfsmvqtubj-lg nfsmvqtubj-xl" access-id="4438cb37-16bc-9866-c48a-eb9537b11370"><div class="znryzltdgl znryzltdgl-sm znryzltdgl-md znryzltdgl-lg znryzltdgl-xl"><div class="rxahnulyct" role="main"><div class="flex flex-column flex-grow fill block"><section class="jultlttlzv" access-id="8f87a9a2-a1db-06c4-cbd6-c3da3ee4ceba"><div class="qvzqlapezl qvzqlapezl-lg"><div class="hzvmrvhplf" role="article"><div class="ProseMirror"><h1 id="5hhen">Frequently Asked Questions</h1></div></div></div></section><section class="awvonjprrj" access-id="3810a0d4-cfe5-8c92-2d8a-39bf78af5e11"><div class="qpplshfrcm qpplshfrcm-lg"><div class="xgulrgjisy" role="article"><div class="ProseMirror"><h3 id="7N2x4"><b><span class="colors-o6n-zg">What is the Data API service?</span></b></h3><p>The Data API service enables traders, data analysts, data scientists and programmers to programmatically access and analyze Wood Mackenzie data via RESTful APIs. It is designed to be simple and intuitive, and is based on widely accepted standards and conventions, including REST, JSON, XML, CSV and HTTP success and error codes. If you already have experience with other publicly available RESTful APIs, you will feel right at home.</p></div></div></div></section><section class="kpojpivhhr" access-id="f40d8c8d-f458-df83-13a1-09cd3ea2728d"><div class="pelsoglxzi pelsoglxzi-lg"><div class="durdyqiiry" role="article"><div class="ProseMirror"><h3 id="wU42W"><b><span class="colors-o6n-zg">How do I access the Data API service?</span></b></h3><p>The Data API service can be accessed from the<a href="/" target="_self"> </a><a href="/" target="_blank">Wood Mackenzie API Portal</a>. You will need to be subscribed to the service and authenticate yourself with a logon ID and password. Contact <a href="mailto:customercare@woodmac.com" target="_blank" rel="noopener noreferrer">customercare@woodmac.com</a> if you have questions about your subscriptions and access to the Data API service.</p></div></div></div></section><section class="hzllaogmrp" access-id="1a57b023-75ce-cc37-cda1-f39909538db2"><div class="tsukqewgqb tsukqewgqb-lg"><div class="xoranbcsmx" role="article"><div class="ProseMirror"><h3 id="qWoi9"><b><span class="colors-o6n-zg">Where can I find examples of code interacting with the Data API service?</span></b></h3><p>Code samples can be found in each API reference. Sample code is available for Curl, Java, C#, Ruby, PHP, JavaScript, Python and Objective-C.</p></div></div></div></section><section class="kgdxcuwzvt" access-id="b31d726a-eeca-7cd7-1d7f-876e11507426"><div class="broxvyrkgc broxvyrkgc-lg"><div class="ghtedthzkp" role="article"><div class="ProseMirror"><h3 id="jwcNK"><b><span class="colors-o6n-zg">Is there an SDK available for Java, Ruby, Python, PHP, etc.?</span></b></h3><p>Not at this time. We hope to make SDKs available at a future date.</p></div></div></div></section><section class="fujjilcnkm" access-id="8bedd47f-90b9-ae75-4c04-bb4b2ff3f66f"><div class="mcuzaccchi mcuzaccchi-lg"><div class="iyhhqkcqav" role="article"><div class="ProseMirror"><h3 id="vcv1e"><b><span class="colors-o6n-zg">I’m not a developer or programmer. Can I still use the Data Service API?</span></b></h3><p>Absolutely. There are many non-programmer tools available for accessing and utilizing APIs. Microsoft Excel is perhaps the most popular tool and you can find a step-by-step guide in the How-To section of the <a href="/#1kQ46" target="_blank">Wood Mackenzie API Portal</a>. Another popular tool used to interact with APIs in a non-programming manner is <a href="https://www.getpostman.com/postman" target="_blank" rel="noopener noreferrer">Postman</a>.</p></div></div></div></section><section class="hijucfvdgk" access-id="85f3affb-5240-cc4d-c9c8-52168ec95126"><div class="hbfuojrled hbfuojrled-lg"><div class="vqboddzfhm" role="article"><div class="ProseMirror"><h3 id="egfaw"><b><span class="colors-o6n-zg">Where do I find my API Key?</span></b></h3><p>Your API key can either be accessed from the <a href="http://myaccount.genscape.com" target="_blank" rel="noopener noreferrer">My Account</a> page or in the <a href="/login-warning" target="_self">API Profile</a> section of the Wood Mackenzie API Portal. Only customers subscribed to products and services containing the Data API service will see their API key. Contact <a href="#" target="">customercare@woodmac.com</a> if you have questions about your subscriptions and access to the Data API service.</p></div></div></div></section><section class="mxurkivbsr" access-id="a0d93177-13db-f45a-84d8-6582a15ac7ab"><div class="gqdrsutbjx gqdrsutbjx-lg"><div class="wxpkfywsvt" role="article"><div class="ProseMirror"><h3 id="2w4o1"><b><span class="colors-o6n-zg">What data sets are available via the Data API Service?</span></b></h3><p>Wood Mackenzie is launching the Data API service with these initial data sets:</p><ul><li><p>North America Power Megawatt Values (proprietary EMF and IR data)</p></li><li><p>European Power Outage (REMIT Urgent Market Messages (UMM))</p></li><li><p>European Availability (Generating Unit Production Capacity)</p></li><li><p>European Power Monitored Generation & Transmission Data</p></li><li><p>Oil Storage</p></li><li><p>Oil Transportation</p></li><li><p>High-Frequency Oil Production</p></li><li><p>Natural Gas Derived Storage Inventories</p></li><li><p>Natural Gas Power Daily Estimates</p></li></ul><p>Additional data sets are constantly being added. The current list can be accessed <a href="/login-warning" target="_self">here</a>.</p></div></div></div></section><section class="epjcwimhxw" access-id="ac40e057-9218-7416-d9b2-640fef128700"><div class="bkccryyqpr bkccryyqpr-lg"><div class="sdlzxnpeab" role="article"><div class="ProseMirror"><h3 id="UUv1i"><b><span class="colors-o6n-zg">What data formats are returned by the Data API service?</span></b></h3><p>JSON, XML and CSV are the supported formats.</p></div></div></div></section><section class="dukggrrtpg" access-id="5a61fc4d-671b-c2c8-b01c-cfd7838c6c42"><div class="lpznclbhrd lpznclbhrd-lg"><div class="zunlzsejcx" role="article"><div class="ProseMirror"><h3 id="FA0AB"><b><span class="colors-o6n-zg">How often is the Wood Mackenzie data updated?</span></b></h3><p>Data freshness varies based on the dataset being requested and the source that it is drawn from. Each API service specifies how often the data is updated.</p></div></div></div></section><section class="sihkshhper" access-id="cf0ced3d-8161-de12-7ef3-2551109ed8b1"><div class="xmaakwzymu xmaakwzymu-lg"><div class="tzxeyxhysu" role="article"><div class="ProseMirror"><h3 id="qZWfn"><b><span class="colors-o6n-zg">How far back does the Data API service go?</span></b></h3><p>Please refer to each API service for details on historical availability start dates.</p></div></div></div></section><section class="ymdoojjkwx" access-id="b2b1fd4a-80a3-998a-9e13-dbbcc0271f53"><div class="ccsledsstx ccsledsstx-lg"><div class="finsofakqq" role="article"><div class="ProseMirror"><h3 id="Z7kBv"><b><span class="colors-o6n-zg">What if I need access to data further back than what’s provided by the Data API Service?</span></b></h3><p>Contact <a href="mailto:customercare@woodmac.com" target="_blank" rel="noopener noreferrer">customercare@woodmac.com</a> to discuss options for obtaining bulk, historical data.</p></div></div></div></section><section class="uunjapogpc" access-id="622ec0b1-e5e2-4c36-77df-88303051fd6d"><div class="vaeljpeklo vaeljpeklo-lg"><div class="axzfcrfjhn" role="article"><div class="ProseMirror"><h3 id="An7tM"><b><span class="colors-o6n-zg">Is there a limit on the amount of items returned per API request?</span></b></h3><p>The default limit is 200 items, but up to 5,000 items can be returned using the Limit parameter.</p></div></div></div></section><section class="ihwxombojw" access-id="31406455-da12-b5c4-f58b-1b730a4a066a"><div class="mgoeuhklxi mgoeuhklxi-lg"><div class="ahqmpahqze" role="article"><div class="ProseMirror"><h3 id="TST0W"><b><span class="colors-o6n-zg">How do I page through data?</span></b></h3><p>By default, GET operations, which return a list of requested items, will return up to 200 items. To get a different set of items, you can use the offset and limit parameters in the query string of the GET request.</p></div></div></div></section><section class="lzdvimekof" access-id="81a13711-8e0b-4066-4c74-68fcd3152a88"><div class="fxguzldofl fxguzldofl-lg"><div class="vufbceqdil" role="article"><div class="ProseMirror"><h3 id="HuEQ7"><b><span class="colors-o6n-zg">Is there a fee to use the Data API service?</span></b></h3><p>The Data API service is included in many Wood Mackenzie subscriptions with data plans and sold as a stand-alone service as well. Additional fees may be applicable for accessing data outside the set rate limits or accessing bulk, historical data. Contact <a href="mailto:customercare@woodmac.com" target="_blank" rel="noopener noreferrer">customercare@woodmac.com</a> if you have questions about your subscriptions and access to the Data API service.</p></div></div></div></section><section class="qjcisyiadv" access-id="c242c0b8-620a-4e9c-8aa8-56b829200e85"><div class="ldsqywscgw ldsqywscgw-lg"><div class="kqjolcebhn" role="article"><div class="ProseMirror"><h3 id="DXRhS"><b><span class="colors-o6n-zg">How do I get support for the Data API service?</span></b></h3><p>Questions about the Data API service can be sent to <a href="mailto:customercare@woodmac.com" target="_blank" rel="noopener noreferrer">customercare@woodmac.com</a>.</p></div></div></div></section><section class="qdzqpnltkn" access-id="1e2d8d9f-bfcf-2424-7f91-9536571b5383"><div class="tyncpudffx tyncpudffx-lg"><div class="iasdnqlnwz" role="article"><div class="ProseMirror"><h3 id="FCvt7"><b><span class="colors-o6n-zg">What are the legal terms and conditions for the Data API service?</span></b></h3><p>The terms and conditions for use of the Data API are described in your subscription MSA contract.</p></div></div></div></section><section class="wjzohrbybo" access-id="69650348-3d78-f5cd-a11a-77e81b2e5902"><div class="jwxlthrxid jwxlthrxid-lg"><div class="jdczwelyld" role="article"><div class="ProseMirror"><h3 id="0wTtc"><b><span class="colors-o6n-zg">Are there API Rate limits for the service?</span></b></h3><p>The API rate limits for the Data API service are:</p><ul><li><p>30 requests per minute, per allotted API Key.</p></li><li><p>1,000 requests per day, per allotted API Key.</p></li></ul><p>Contact <a href="mailto:customercare@woodmac.com" target="_blank" rel="noopener noreferrer">customercare@woodmac.com</a> for pricing options beyond the standard rate limits above.</p></div></div></div></section><section class="jjhihgljxp" access-id="814e4a20-53f3-286d-5fa1-f3a6b2352663"><div class="wchukrnljq wchukrnljq-lg"><div class="txlqxufdwa" role="article"><div class="ProseMirror"><h3 id="ZzoEf"><b><span class="colors-o6n-zg">Is there a way to see usage history for the Data API service?</span></b></h3><p>Yes. You can see current day, yesterday and last 30 and 90-day history under the <a href="/login-warning" target="_self">API Usage Analytics</a> section of the Wood Mackenzie API Portal.</p></div></div></div></section><section class="pxvymfikft" access-id="b85a659b-5f0d-7cb4-385c-f8290f9d7b91"><div class="wpjzkbaqdp wpjzkbaqdp-lg"><div class="swyyuslgah" role="article"><div class="ProseMirror"><h3 id="k0n6t"><b><span class="colors-o6n-zg">Will the Data API service change over time?</span></b></h3><p>We reserve the right to change or deprecate APIs over time - we will provide customers ample notification in those cases.</p></div></div></div></section><section class="rwlojmatam" access-id="39ee082b-e61e-ac68-9be0-c8ca54e13530"><div class="kedldyffas kedldyffas-lg"><div class="cesvxlycxa" role="article"><div class="ProseMirror"><h3 id="eSaDV"><b><span class="colors-o6n-zg">Where can I submit feedback and feature requests for the API?</span></b></h3><p>Please submit feedback and enhancement requests to <a href="mailto:customercare@woodmac.com" target="_blank" rel="noopener noreferrer">customercare@woodmac.com</a>.</p></div></div></div></section><section class="nkuewivvtf" access-id="8e9a5f03-d970-d71a-5d22-d389d38338e8"><div class="enetxrwdjk enetxrwdjk-lg"><div class="fwxdwtrhqq" role="article"><div class="ProseMirror"><h3 id="f1tz5"><b><span class="colors-o6n-zg">Can I redistribute applications or code that utilizes the Data API service commercially?</span></b></h3><p>The use of the Data API service is restricted to Wood Mackenzie subscribed customers’ internal use only and governed by your Wood Mackenzie subscription MSA.</p></div></div></div></section><section class="mvenjvtyeo" access-id="b7218e95-a35c-77a8-0ab6-93811b69eba3"><div class="ermrglauip ermrglauip-lg"><div class="fkdrjkclmr" role="article"><div class="ProseMirror"><h3 id="6E9vp"><b><span class="colors-o6n-zg">What are the common errors that might be returned by an API?</span></b></h3><p>The Data API service follows standard HTTP REST practices, so typical HTTP response codes apply. These include:</p><ul><li><p>400 - Bad Request. Request had bad syntax or the parameters supplied were invalid.</p></li><li><p>401 - Unauthorized. API Authorization failed.</p></li><li><p>403 - Forbidden. You do not have permission to access the endpoint with the parameters supplied.</p></li><li><p>404 - Not found. Server did not find a route matching the given URI.</p></li><li><p>429 - Too many requests. You have exceeded the defined rate limit for your subscription.</p></li><li><p>500 - Server encounterd an unexpected condition which prevented it from fulfilling the request.</p></li></ul></div></div></div></section></div></div></div></section><section class="flsbrjhydb flsbrjhydb-sm flsbrjhydb-md flsbrjhydb-lg flsbrjhydb-xl" access-id="75c4b954-07f4-f973-96a7-c12b15d88dbe"><div class="tzyyathlgq tzyyathlgq-sm tzyyathlgq-md tzyyathlgq-lg tzyyathlgq-xl"><div class="kyknvgscge kyknvgscge-md" role="aside"><iframe frameborder="0" allow="clipboard-read; clipboard-write; camera; microphone; geolocation" sandbox="allow-scripts allow-modals allow-forms allow-popups allow-popups-to-escape-sandbox allow-top-navigation allow-pointer-lock" src="/content/html_widgets/YFsN8.html" class="giwdylrjno giwdylrjno-sm giwdylrjno-md giwdylrjno-lg giwdylrjno-xl"></iframe></div><div class="azxzbmywfb azxzbmywfb-md" role="article"><iframe frameborder="0" allow="clipboard-read; clipboard-write; camera; microphone; geolocation" sandbox="allow-scripts allow-modals allow-forms allow-popups allow-popups-to-escape-sandbox allow-top-navigation allow-pointer-lock" src="/content/html_widgets/zCeKM.html" class="fmmnryimgc fmmnryimgc-sm fmmnryimgc-md fmmnryimgc-lg fmmnryimgc-xl"></iframe></div></div></section></div><script type="text/javascript" src="/_Incapsula_Resource?SWJIYLWA=719d34d31c8e3a6e6fffd425f7e032f3&ns=1&cb=1206222672" async></script></body></html>