Econdb Getting Started Guide: API Keys & First Request (2026)

Getting started overview

Integrating with Econdb involves a sequence of steps designed to get you retrieving economic data efficiently. This guide outlines the process from account creation to executing your first API call. The Econdb API provides access to a range of economic indicators and datasets, which can be useful for applications in finance, research, and data visualization.

The core of the integration relies on a RESTful API, accessible via HTTP requests, and secured using an API key for authentication. Econdb supports common data formats for responses, simplifying integration into various programming environments. While the API is language-agnostic, examples in this guide will primarily use Python, a common language for data science and web development.

Below is a quick reference table summarizing the initial steps:

Following these steps will enable you to retrieve data programmatically, such as GDP growth rates, inflation figures, or unemployment statistics, which can then be integrated into your applications or analysis workflows.

Create an account and get keys

To begin using the Econdb API, you must first create an account on the Econdb platform. This account provides access to your personal dashboard, where you can manage your subscriptions and retrieve your API key.

1. Navigate to the Econdb Homepage: Open your web browser and go to www.econdb.com.
2. Sign Up: Look for a "Sign Up" or "Register" button, typically located in the top right corner of the page. Click on it to initiate the account creation process.
3. Provide Information: You will likely be prompted to enter your email address and create a password. Follow the on-screen instructions to complete the registration. Econdb offers a free tier that allows up to 50 API calls per day, which is suitable for initial testing and development.
4. Access Your Dashboard: After successful registration and logging in, you will be redirected to your Econdb user dashboard.
5. Locate Your API Key: Within your dashboard, there will be a section dedicated to API keys or developer settings. The exact location may vary, but it is usually clearly labeled. Your API key is a unique string of characters that authenticates your requests to the Econdb API. Copy this key and store it securely, as it is essential for all subsequent API calls. Do not share your API key publicly or embed it directly into client-side code, as this could compromise your account limits and data security.

Once you have your API key, you are ready to make your first request to the Econdb API.

Your first request

This section demonstrates how to make a basic API request to Econdb using Python. The example retrieves a specific economic indicator. Before proceeding, ensure you have Python installed on your system. You can download Python from the official Python website.

Prerequisites

• Python 3.x installed.
• requests library installed. You can install it using pip: pip install requests.
• Your Econdb API key.

Example: Fetching GDP data (Python)

This example demonstrates how to retrieve Gross Domestic Product (GDP) data for a specific country using the Econdb API. The Econdb API reference provides details on available endpoints and parameters for various economic indicators.

import requests
import os

# Replace with your actual Econdb API Key
# It's recommended to store API keys as environment variables for security
api_key = os.environ.get("ECONDB_API_KEY", "YOUR_ECONDB_API_KEY")

# Define the API endpoint for fetching series data
base_url = "https://www.econdb.com/api/series/"

# Example: Fetching United States GDP (quarterly, current prices)
# You can find series IDs in the Econdb documentation or by browsing the Econdb website.
series_id = "USGDP" # Example ID for US GDP

# Construct the full URL with parameters
params = {
    "api_key": api_key,
    "format": "json" # Request JSON format for the response
}

# Make the GET request to the Econdb API
try:
    response = requests.get(f"{base_url}{series_id}/", params=params)
    response.raise_for_status() # Raise an exception for HTTP errors (4xx or 5xx)
    data = response.json()

    # Process and print the retrieved data
    print(f"Successfully retrieved data for series: {series_id}")
    if "data" in data and "values" in data["data"]:
        # Print the last few data points as an example
        print("Last 5 data points:")
        for entry in data["data"]["values"][-5:]:
            print(f"  Date: {entry['date']}, Value: {entry['value']}")
    else:
        print("No data values found in the response.")

except requests.exceptions.HTTPError as http_err:
    print(f"HTTP error occurred: {http_err} - {response.text}")
except requests.exceptions.ConnectionError as conn_err:
    print(f"Connection error occurred: {conn_err}")
except requests.exceptions.Timeout as timeout_err:
    print(f"Timeout error occurred: {timeout_err}")
except requests.exceptions.RequestException as req_err:
    print(f"An error occurred: {req_err}")
except Exception as e:
    print(f"An unexpected error occurred: {e}")

Running the code

1. Save the code above as a Python file (e.g., econdb_gdp.py).
2. Replace "YOUR_ECONDB_API_KEY" with your actual API key obtained from your Econdb dashboard. For better security practices, consider setting your API key as an environment variable and accessing it using os.environ.get("ECONDB_API_KEY") as shown in the example.
3. Open your terminal or command prompt, navigate to the directory where you saved the file, and run it using: python econdb_gdp.py.

The script will print the retrieved data, demonstrating a successful connection and data retrieval from the Econdb API. This foundational request can be extended to query other available economic series by modifying the series_id and exploring additional parameters detailed in the Econdb API documentation.

Common next steps

After successfully making your first request, consider these common next steps to further integrate Econdb data into your projects:

• Explore More Endpoints: Review the Econdb API reference to discover other available endpoints. Econdb offers various categories of economic data, including national accounts, labor markets, prices, and financial statistics. Understanding the different endpoints will allow you to retrieve the specific data required for your application.
• Filter and Parameterize Requests: Learn how to use query parameters to filter data by date ranges, frequency (e.g., monthly, quarterly, annually), and other criteria. This allows for more granular control over the data you retrieve, reducing the amount of post-processing required.
• Error Handling: Implement robust error handling in your code to gracefully manage API rate limits, invalid requests, or server errors. The Econdb documentation provides details on common error codes and their meanings. For general guidance on API error handling, consult resources like the Mozilla Developer Network HTTP status codes guide.
• Data Visualization: Integrate the retrieved economic data into charting libraries (e.g., Matplotlib, Plotly in Python; D3.js in JavaScript) to create visualizations that highlight trends and patterns.
• Automate Data Retrieval: For applications requiring regular updates, set up scheduled tasks or cron jobs to periodically fetch new data from Econdb. Be mindful of your API call limits as specified by your Econdb subscription plan.
• Explore SDKs (if available): Although Econdb doesn't currently list official SDKs, community-contributed libraries might exist for popular languages. These can simplify API interactions by abstracting HTTP requests and JSON parsing.
• Upgrade Your Plan: If your project requires more than 50 API calls per day, consider upgrading your Econdb subscription. The Econdb pricing page outlines various tiers, starting from the Hobbyist plan at $10/month.

Troubleshooting the first call

When making your first API call, you might encounter common issues. Here are some troubleshooting steps:

• Invalid API Key:
  • Issue: The most common problem is an incorrect or missing API key. You might receive a 401 Unauthorized or 403 Forbidden error.
  • Solution: Double-check that you have copied your API key correctly from your Econdb dashboard. Ensure there are no leading or trailing spaces. Verify that the key is correctly passed in your request parameters as api_key.
• Rate Limit Exceeded:
  • Issue: If you make too many requests in a short period, especially on the free tier, you may hit a rate limit and receive a 429 Too Many Requests error.
  • Solution: Wait for a few minutes before trying again. For sustained higher usage, consider upgrading your Econdb plan.
• Incorrect Endpoint or Series ID:
  • Issue: Requesting a non-existent endpoint or an invalid series_id can lead to 404 Not Found errors or empty data responses.
  • Solution: Refer to the Econdb API documentation to confirm the correct endpoint paths and available series IDs. Ensure the URL is correctly constructed.
• Network Issues:
  • Issue: Problems with your internet connection or Econdb's servers can prevent successful requests.
  • Solution: Check your internet connection. You can also visit the Econdb website to see if there are any service status updates.
• JSON Parsing Errors:
  • Issue: If the API returns valid data but your code fails to parse it, you might have an issue with how you're handling the JSON response.
  • Solution: Ensure you are using a proper JSON parser (e.g., response.json() in Python's requests library). Print the raw response.text to inspect the API's output directly and verify its structure.
• Environment Variable Issues:
  • Issue: If you're using environment variables for your API key, they might not be loaded correctly.
  • Solution: Verify that the environment variable is set and accessible in the context where your script is running. On Linux/macOS, you can test with echo $ECONDB_API_KEY. On Windows, use echo %ECONDB_API_KEY% in Command Prompt or $env:ECONDB_API_KEY in PowerShell.

By systematically checking these points, you can often quickly resolve issues preventing a successful first API call to Econdb.