Getting your App Key and ID

Getting your App Key and ID

How to Get Started

Developer

Create a Developer account for access to features of Oxford Dictionaries API and start enhancing your application with the most renowned, trusted language content available. You are only ever charged for what you use (see Pricing) and there is no minimum term contract. See our Terms and Conditions.

Your App ID and App Key, which you will need to pass as authentication headers for each API request, will be displayed as part of your application credentials after you sign in to the developer portal.

  1. import requests
  2. import json
  3. app_id = "<your_app_id>"
  4. app_key = "<your_app_key>"
  5. language = "en-gb"
  6. word_id = "example"
  7. url = "https://od-api.oxforddictionaries.com:443/api/v2/entries/" + language + "/" + word_id.lower()
  8. r = requests.get(url, headers={"app_id": <your_app_id>, "app_key": <your_app_key>})
Sample Entries request in Python, using your App ID and App Key

Prototype

Prototype accounts give you access to the Entries and Lemmas endpoints and a maximum of 1000 requests per month, allowing you to explore the API's basic functionality, and includes access to English and Spanish datasets. You can upgrade to a Developer or Enterprise account as your needs change.


Enterprise

If your requirements include using data offline or caching it within your application, or you are interested in hearing about other data we have to license that is not available via the Developer API plan, one of our team would be happy to speak to you and discuss your requirements. Our Enterprise account offers access to all English datasets and endpoints, including monolingual content, as well as Spanish sentences in the sentences endpoints. Fill in a contact form HERE and you will hear from us shortly.

Pricing

Our pay-as-you-go model means you only ever pay for what you use, and the more you use, the greater the discount on the cost of each request.

Charges are calculated at the beginning of each calendar month for the month previous and charged to your payment card in Great British Pounds (GBP). If you change your Application Plan during the month you are still liable for any charges accrued in that month up to that date.

  • 1 – 10,000 requests
  • 10,001 – 100,000 requests
  • 100,000 + requests
  • GBP 0.002 per request
  • GBP 0.001 per request
  • GBP 0.0005 per request


For full access to access to endpoints for non-English datasets, you can change your Application Plan at any time using the ‘Update my plan’ button on the Applications page in your account. If you require access to the full range of English datasets and endpoints, including monolingual content, please fill in our Enterprise account contact form HERE and you will hear from us shortly.

Update your plan at any time

Manage your account

You can manage many aspects of your account quickly and efficiently by signing in to the developer portal.

  • Track your usage Statistics.
  • Change your Application Plan.
  • View your Invoices and update your payment details.