Getting Started with the GinzaMetrics API

The API is available to all customers, but you will need to request an API key from the GinzaMetrics support team. Please email to request your API key.

Finding Your Key

Once you have been granted access, you can access your API key by going to your user settings page.

GinzaMetrics Settings

On your settings page, at the bottom of the screen, find your API key.

GinzaMetrics API Key

Making Requests

The API is language agnostic and can easily be tested using cURL:

curl \
-d api_key= 292msm93msk392m2292md<br />

The response should look something like this:

{"version": "GinzaMetrics API v3.x",
 "copyright":"Ginzamarkets, Inc 2010-2013",
 "authenticated-user":"Alonzo C.",

API Architecture

The API is actually divided into several APIs and is continuously being expanded. The existing APIs are as follows:

  • Keyword Reporting API
  • Optimization API
  • Account Management API


Changes to the API will be posted on the API changelog.

Reporting Bugs

If you find bugs with the API, please email us at

API Feature Requests

Because the API methods are still being added to the current version (v3.0), there may be functionality that exists in the GinzaMetrics Dashboard that is not yet available in the API. If this is the case, please contact your Account Manager and we will contact you to discuss roadmap and integration timing.