API Documentation
NAICS code lookups, company searches, and industry classification. The API is free and public — no API key or account required.
Quick Start
Suggest a code from descriptionGET
curl "https://naics.me/api/naics-suggest?q=software+development"Lookup a public companyGET
curl "https://naics.me/api/sec/company?ticker=AAPL"Access
- Free for everyone — no API key, no account, no quotas
- CORS enabled — use from any frontend
Data Endpoints
GET
/api/naics-suggest?q={description}Suggest NAICS codes from a business description. Returns top 10 matches with relevance scores.
Parameters
qrequiredBusiness description or keywordExample RequestGET
curl "https://naics.me/api/naics-suggest?q={description}"Example Response
{
"results": [
{ "code": "541511", "title": "Custom Computer Programming Services", "score": 0.92 },
{ "code": "541512", "title": "Computer Systems Design Services", "score": 0.78 }
]
}GET
/api/naics/validate?code={code}Validate a NAICS code and return its level (Sector through National Industry).
Parameters
coderequired2-6 digit NAICS codeExample RequestGET
curl "https://naics.me/api/naics/validate?code={code}"Example Response
{
"valid": true,
"code": "541511",
"title": "Custom Computer Programming Services",
"level": 6,
"levelName": "National Industry",
"message": "541511 is a valid National Industry."
}GET
/api/sec/company?ticker={ticker}Lookup a public company's NAICS code by SEC ticker symbol. Returns company name, SIC, and mapped NAICS.
Parameters
tickerrequiredStock ticker symbol (e.g., AAPL, TSLA)Example RequestGET
curl "https://naics.me/api/sec/company?ticker={ticker}"Example Response
{
"ticker": "AAPL",
"name": "Apple Inc",
"cik": "0000320193",
"sic": "3571",
"sicDescription": "Electronic Computers",
"naics": "334111",
"naicsTitle": "Electronic Computer Manufacturing"
}GET
/api/companies/search?q={query}Search public companies by ticker, name, or NAICS title. Returns top 10 scored matches.
Parameters
qrequiredTicker, company name, or industry keywordExample RequestGET
curl "https://naics.me/api/companies/search?q={query}"Example Response
{
"results": [
{ "ticker": "AAPL", "name": "Apple Inc", "cik": "0000320193", "sic": "3571", "sicDescription": "Electronic Computers", "naics": "334111", "naicsTitle": "Electronic Computer Manufacturing" }
]
}GET
/api/companies/peers?naics={naics}&exclude={ticker}Find peer companies that share the same or similar NAICS classification.
Parameters
naicsrequiredNAICS code (2-6 digits)excludeTicker to exclude from resultsExample RequestGET
curl "https://naics.me/api/companies/peers?naics={naics}&exclude={ticker}"Example Response
{
"peers": [
{ "ticker": "DELL", "name": "Dell Technologies Inc", "naics": "334111" },
{ "ticker": "HPQ", "name": "HP Inc", "naics": "334111" }
]
}POST
/api/corporate-connectionAnalyze the relationship between two companies using their NAICS/SIC classifications. Returns relationship type, competitive overlap, and shared traits.
Parameters
tickerArequiredFirst company tickertickerBrequiredSecond company tickerExample RequestPOST
curl -X POST "https://naics.me/api/corporate-connection" \
-H "Content-Type: application/json" \
-d '{"tickerA":"AAPL","tickerB":"MSFT"}'Example Response
{
"connection": {
"relationship": "competitors",
"summary": "Apple and Microsoft compete across multiple product categories...",
"sharedTraits": ["Technology sector", "Consumer electronics", "Cloud services"],
"differences": ["Hardware focus vs software/services focus"],
"competitiveOverlap": "high",
"industryContext": "Both companies operate at the intersection of hardware, software, and cloud services..."
}
}GET
/api/sec/ticker-mapReturns the complete mapping of SEC tickers to CIK numbers. Useful for batch lookups.
Example RequestGET
curl "https://naics.me/api/sec/ticker-map"Example Response
{
"AAPL": "0000320193",
"MSFT": "0000789019",
"TSLA": "0001318605"
}GET
/api/healthHealth check endpoint. Returns 200 OK when the service is operational.
Example RequestGET
curl "https://naics.me/api/health"Example Response
{"status":"ok"}Authentication Endpoints
POST
/api/auth/registerCreate an account. Sends a verification email.
Parameters
emailrequiredYour email addresspasswordrequiredMin 8 charactersExample RequestPOST
curl -X POST "https://naics.me/api/auth/register" \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"secret123"}'Example Response
{
"userId": 1,
"email": "you@example.com",
"message": "Account created. Please check your email to verify your address."
}POST
/api/auth/loginSign in with email and password. Sets a session cookie.
Parameters
emailrequiredYour email addresspasswordrequiredYour passwordExample RequestPOST
curl -X POST "https://naics.me/api/auth/login" \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"secret123"}'Example Response
{
"userId": 1,
"email": "you@example.com",
"emailVerified": true,
"message": "Logged in successfully."
}GET
/api/auth/meGet the current authenticated user.
Example RequestGET
curl "https://naics.me/api/auth/me"Example Response
{
"userId": 1,
"email": "you@example.com",
"emailVerified": true,
"createdAt": "2026-05-21T12:00:00Z"
}POST
/api/auth/logoutClear the session cookie and sign out.
Example RequestPOST
curl -X POST "https://naics.me/api/auth/logout" \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"secret123"}'Example Response
{"message":"Logged out successfully."}POST
/api/auth/forgot-passwordRequest a password reset link. Requires a verified email address.
Parameters
emailrequiredYour email addressExample RequestPOST
curl -X POST "https://naics.me/api/auth/forgot-password" \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"secret123"}'Example Response
{"message":"If an account exists for this email, you will receive reset instructions."}POST
/api/auth/reset-passwordReset password using a token from the forgot-password email.
Parameters
tokenrequiredReset token from emailnewPasswordrequiredMin 8 charactersExample RequestPOST
curl -X POST "https://naics.me/api/auth/reset-password" \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"secret123"}'Example Response
{"message":"Password reset successfully. All other sessions have been signed out."}POST
/api/auth/change-passwordChange password while authenticated. Rotates session and invalidates all other sessions.
Parameters
currentPasswordrequiredYour current passwordnewPasswordrequiredMin 8 charactersExample RequestPOST
curl -X POST "https://naics.me/api/auth/change-password" \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"secret123"}'Example Response
{"message":"Password updated. All other sessions have been signed out."}GET
/api/auth/verify-email?token={token}Verify your email address using the link from the signup email.
Parameters
tokenrequiredVerification token from emailExample RequestGET
curl "https://naics.me/api/auth/verify-email?token={token}"Example Response
{"message":"Email verified successfully."}All data is sourced from the U.S. Census Bureau 2022 NAICS Manual, SEC EDGAR filings, and USAspending.gov. API responses are cached for 1 hour. For questions or commercial use, contact admin@naics.me.