AlphaGeo Public Docs
  • Welcome
  • Product Guides
    • Climate Risk and Resilience Index
      • Methodology (1/3): Resilience-adjusted Risk Framework
      • Methodology (2/3): Global Adaptation Layer
      • Methodology (3/3): Indexing
      • Data Sources
      • AlphaGeo versus the Market: Climate Risk & Resilience Index
    • Financial Impact Analytics
      • Methodology
      • Use Case: AlphaGeo for Climate-adjusted Valuation
    • Location Dynamism Signals
    • Pricing
  • Platform guides
    • Trial
    • Location Explorer
    • Portfolio Analytics
      • Data Manager
      • Data Filter
      • Analytics
      • Multi-asset Heatmap
      • Single-asset Property Map
      • Sharing Analytics
    • Admin Panel
  • Data Access and Delivery
  • SAMPLE USE CASES
    • AlphaGeo for Regulatory Disclosures
    • AlphaGeo for Asset Valuation
  • For Developers
    • Data APIs
      • Global Climate Risk Index API
      • Global Adaptation Layers Risk API
      • Global Adaptation Layers Resilience API
      • Climate Financial Impact API
    • Data Dictionary
    • Snowflake Native Application
Powered by GitBook
On this page
  • Overview
  • Access Tokens
  • Rate Limits
  1. For Developers

Data APIs

PreviousAlphaGeo for Asset ValuationNextGlobal Climate Risk Index API

Last updated 7 months ago

Overview

The AlphaGeo API suite offers powerful tools to access climate risk scoring data for global locations programmatically. With these APIs, you can seamlessly integrate climate risk information into your applications, enabling data-driven decision-making and risk assessment.

The AlphaGeo APIs are structured into three primary services: Scores, Physical Risk, and Resilience-adjusted Risk. Each service provides distinct capabilities tailored to address specific climate risk assessment needs.

Access Tokens

To access AlphaGeo APIs, you need to obtain an access token. Access tokens are unique identifiers that grant you permission to use our services. Follow these steps to obtain and use your access token:

Sign Up or Log In

If you haven't already, . If you already have an account, log in to the AlphaGeo dashboard. (You will need an to access this feature!)

Ensure you have adequate in-app permissions

You can easily check this in your account. Once logged in, navigate to the upper right-hand corner of the dashboard.

Get Access Token

Copy the token found upon clicking "API" in the upper-right section of your account. Treat this token as sensitive information and keep it secure.

Use Access Token in Requests

In your API requests, include the access token in the headers. Add an Authorization header with the value "[your_access_token]". Replace "[your_access_token]" with the actual access token you obtained.

$ curl -X GET \
  'https://app.alphageo.ai/api/public/v1/physical_risk/?address=New+York&period=2050&scenario=SSP585&longitude=-74.0059&latitude=40.7128' \
  -H 'Authorization: 123xxxx'

Refresh Token (Optional)

we recommend that clients routinely "refresh" their token as an added security measure.

Rate Limits

Every interaction with AlphaGeo APIs is subject to rate limits, which restrict the number of requests allowed per endpoint. These limits are in place to ensure fair usage and maintain system performance. Here's what you need to know about rate limits:

What Happens If You Exceed the Limit?

If you exceed the rate limit, you'll receive an HTTP 429 Too Many Requests response from the API. This response indicates that your request cannot be processed immediately due to exceeding the allowed rate.

API
Default requests per minute

Scores

60 requests per minute

Physical Risk

60 requests per minute

Resilience-adjusted Risk

60 requests per minute

Analytics

60 requests per minute

Need a Higher Limit?

If your application requires a higher rate limit than the default – don't worry! Simply reach out to our dedicated , and we'll be happy to assist you.

support team

sign up for an AlphaGeo account
Enterprise Subscription

Climate Risk Scores API
Physical Risk API
Resilience-adjusted Risk API
Financial Impact API