API Overview
The Risk Runners API provides programmatic access to our comprehensive corporate risk intelligence database. Access risk factor analysis, industry classifications, and company data through RESTful endpoints designed for developers, researchers, and financial professionals.
Current Status: The API is currently in development. This documentation outlines the planned functionality and endpoints that will be available in the initial release.
🔌 API Capabilities
Company Risk Data
Risk Factors • Industry Classification • Risk Scores
Access comprehensive risk profiles for 2000+ companies including detailed risk factor analysis and scoring.
Search & Discovery
Full-text Search • Filtering • Fuzzy Matching
Powerful search capabilities across companies, industries, risk factors, and event codes with advanced filtering.
Industry Analysis
Sector Data • Peer Comparison • Risk Aggregation
Industry-level risk analysis, sector comparisons, and aggregated risk metrics across industry categories.
📋 Planned API Endpoints
Companies
GET /api/companies
GET /api/companies/{id}
Retrieve company information and risk profiles
Search
GET /api/search
POST /api/search/advanced
Search across all risk intelligence data
Industries
GET /api/industries
GET /api/industries/{sector}
Industry classifications and sector analysis
Risk Factors
GET /api/risk-factors
GET /api/risk-factors/{category}
Risk factor data and categorization
Example API Responses
Company Risk Profile
{
"company": {
"id": "AAONINC",
"name": "AAON Inc",
"ticker": "AAON",
"industry": "Electrical Components and Equipment",
"market_cap_category": "small_cap",
"risk_score": {
"overall": 6.2,
"regulatory": 5.8,
"operational": 7.1,
"financial": 5.9,
"market": 6.8,
"strategic": 6.0
},
"risk_factors": [
{
"category": "Economic",
"description": "Business affected by economic factors and activity levels",
"severity": "medium"
},
{
"category": "Supply Chain",
"description": "Dependent on raw materials and component availability",
"severity": "high"
}
],
"industries": [
"Automobiles and Components",
"Electrical Components and Equipment",
"Application Software",
"Environmental Services"
],
"last_updated": "2024-12-30T00:00:00Z"
}
}Industry Risk Summary
{
"industry": {
"name": "Technology",
"companies_count": 450,
"subcategories": [
{
"name": "Software",
"companies": 180,
"avg_risk_score": 5.8
},
{
"name": "Hardware",
"companies": 120,
"avg_risk_score": 6.4
}
],
"common_risks": [
"Regulatory Risk",
"Competition",
"Cybersecurity"
],
"risk_distribution": {
"high": 85,
"medium": 280,
"low": 85
}
}
}Authentication & Rate Limits
💻 Usage Examples
Python Example
requests • pandas • data analysis
import requests
# Get company risk profile
response = requests.get(
'https://api.riskrunners.com/companies/AAONINC',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
company_data = response.json()
risk_score = company_data['company']['risk_score']['overall']JavaScript Example
fetch • async/await • web integration
// Search for technology companies
const response = await fetch(
'https://api.riskrunners.com/search?q=technology&type=industry',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const results = await response.json();cURL Example
command line • testing • automation
curl -X GET \
'https://api.riskrunners.com/industries/technology' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json'💰 Pricing Plans
Free Tier
1,000 requests/hour
Basic company data
Community support
$0/month
Professional
10,000 requests/hour
Full risk analysis
Priority support
$99/month
Enterprise
Unlimited requests
Custom integrations
Dedicated support
Contact us
Academic
5,000 requests/hour
Research use only
Educational discount
$29/month
🚀 Getting Started
The Risk Runners API is currently in development. To be notified when the API becomes available and to request early access:
- Join the waitlist: Sign up for API access notifications
- Review documentation: Familiarize yourself with the planned endpoints and data structures
- Plan your integration: Design your application around the available data and rate limits
- Request early access: Contact us for beta testing opportunities
For questions about API access, custom integrations, or enterprise solutions, please contact us through the links below.
🛠️ Developer Support
Documentation
API Reference • Guides • Examples
Comprehensive documentation with code examples, best practices, and integration guides.
Community
GitHub • Issues • Discussions
Open source community support through GitHub issues and developer discussions.
Professional Support
Email • Priority Response • Custom Solutions
Dedicated support for professional and enterprise users with guaranteed response times.