Introduction to the company_dns
The company_dns acts as a "domain name service" for company information, providing structured access to firmographic data from multiple sources. This tool allows you to:
- Search industry codes across multiple classification systems
- Retrieve company information from Wikipedia and EDGAR
- Access standardized data through a consistent RESTful API
- Compare industry classifications across different international standards
Deployment Options
Self-Hosted
Running as your own instance, perhaps in Docker
http://localhost:8000
What is company_dns?
The company_dns integrates data from multiple sources to provide comprehensive firmographic information about companies. Currently, it combines:
Industry Classifications
- US SIC (Standard Industry Classification)
- UK SIC (United Kingdom Standard Industrial Classification)
- ISIC (International Standard Industrial Classification)
- EU NACE (European Classification of Economic Activities)
- Japan SIC (Japan Standard Industrial Classification)
Company Data
- Wikipedia - General company information
- EDGAR - SEC filings and financial data
- Merged sources - Combined firmographic data
API Versions
The company_dns API is available in two versions:
V3.0 (Current)
The latest version with regional path structure:
/V3.0/na/...- North America specific endpoints/V3.0/uk/...- United Kingdom specific endpoints/V3.0/eu/...- European Union specific endpoints/V3.0/japan/...- Japan specific endpoints/V3.0/international/...- International standards/V3.0/global/...- Global data across regions
V2.0 (Legacy)
The previous version with simpler path structure:
/V2.0/...- All endpoints without regional specificity
Note: V2.0 is maintained for backwards compatibility but new development should use V3.0
API Documentation
Interactive API Explorer
The most comprehensive way to explore and test the API is through our interactive API Reference page, which provides real-time request/response testing, automatic schema validation, and detailed documentation.
Why Use the API Reference?
- Live Testing: Try requests directly without writing code
- Schema Validation: See request/response models in detail
- Documentation: Full endpoint descriptions and parameter explanations
- Request History: Keep track of recent API calls
- OpenAPI Standard: Industry-standard REST API interface
Response Format
All endpoints return JSON responses with a consistent structure:
{
"code": 200, // HTTP status code
"message": "Success", // Status message
"total": 5, // Total number of results
"data": {
"results": [ // Array of result objects
{
// Result properties depend on the endpoint
}
]
}
}API Versions
The company_dns API is available in two versions. See the code examples below for version-specific endpoints.
Using the Industry Classification Explorer
The Industry Classification Explorer allows you to search across multiple industry classification systems using keywords. This is useful for finding comparable industry codes across different standards.
Step 1: Enter a Search Term
Enter an industry keyword in the search box (e.g., "oil", "manufacturing", "retail").
Example Searches:
oilcomputerretailmanufacturing
Step 2: Filter Results
Use the checkboxes on the left to filter results by classification system:
- US SIC - United States Standard Industrial Classification
- UK SIC - United Kingdom Standard Industrial Classification
- EU NACE - European Classification of Economic Activities
- ISIC - International Standard Industrial Classification
- Japan SIC - Japan Standard Industrial Classification
Step 3: Explore Results
Each result shows:
- Classification system badge
- Industry description
- Industry code
- Additional details when available
Pro Tip
Use broader terms for more comprehensive results. For example, search for "computer" instead of "computer manufacturing" to find all related industries.
Using the EDGAR Explorer
The EDGAR Explorer provides a powerful interface to search SEC EDGAR filings by company name or CIK. It allows you to discover and explore annual reports (10-K) and quarterly reports (10-Q) filed with the SEC.
Step 1: Search for a Company
Enter a company name (e.g., IBM, Apple) or a CIK number (e.g., 0000051143) in the search field.
Example Searches:
- Company name:
IBM,Apple,Microsoft - CIK:
0000051143,0000789019
Step 2: Apply Filters (Optional)
Use the sidebar filters to narrow your results:
- Has 10‑K — Show only companies with annual report filings
- Recent 10‑Q — Show only quarterly reports filed within the last 90 days
- Division — Filter by SIC division (dynamically populated from results)
- Fiscal Year End — Filter by fiscal year end date (MM/YY format)
Step 3: Review Company Information
Results display comprehensive company data including:
- Company name and CIK
- SIC code and description
- Division classification
- Ticker symbol and exchange
- Fiscal year end
- Location (city, state, address)
Step 4: Access Filings
Click the 10‑K or 10‑Q buttons to access the latest filings. The buttons display:
10‑K • YYYY-MM-DD— Latest annual report with filing date10‑Q • YYYY-MM-DD— Latest quarterly report; highlighted if filed within 90 days
Step 5: View Raw Data
Click View JSON in the top-right to see the raw API response for any filing result.
Industry Classification Explorer
Search across multiple industry classification systems to find and compare codes for various business activities. This tool helps you identify equivalent categories across different standards.