quick_start.py

import os
import unicodecsv
from groclient import GroClient

API_HOST = 'api.gro-intelligence.com'
OUTPUT_FILENAME = 'gro_client_output.csv'
ACCESS_TOKEN = os.environ['GROAPI_TOKEN']


def main():
    client = GroClient(API_HOST, ACCESS_TOKEN)

    selected_entities = {'region_id': 1210,  # Ukraine
                         'item_id': 95,  # Wheat
                         'metric_id': 570001}  # Area Harvested (area)

    writer = unicodecsv.writer(open(OUTPUT_FILENAME, 'wb'))

    # Get what possible series there are for that combination of selections
    for data_series in client.get_data_series(**selected_entities):

        # Add a time range restriction to your data request
        # (Optional - otherwise get all points)
        data_series['start_date'] = '2000-01-01'
        data_series['end_date'] = '2012-12-31'

        for point in client.get_data_points(**data_series):
            writer.writerow([
                point['start_date'],
                point['end_date'],
                point['value'],
                client.lookup_unit_abbreviation(point['unit_id'])
            ])


if __name__ == "__main__":
    main()