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 keyword
Example 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 code
Example 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 keyword
Example 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 results
Example 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-connection
Analyze the relationship between two companies using their NAICS/SIC classifications. Returns relationship type, competitive overlap, and shared traits.

Parameters

tickerArequiredFirst company ticker
tickerBrequiredSecond company ticker
Example 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-map
Returns 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/health
Health 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/register
Create an account. Sends a verification email.

Parameters

emailrequiredYour email address
passwordrequiredMin 8 characters
Example 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/login
Sign in with email and password. Sets a session cookie.

Parameters

emailrequiredYour email address
passwordrequiredYour password
Example 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/me
Get 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/logout
Clear 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-password
Request a password reset link. Requires a verified email address.

Parameters

emailrequiredYour email address
Example 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-password
Reset password using a token from the forgot-password email.

Parameters

tokenrequiredReset token from email
newPasswordrequiredMin 8 characters
Example 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-password
Change password while authenticated. Rotates session and invalidates all other sessions.

Parameters

currentPasswordrequiredYour current password
newPasswordrequiredMin 8 characters
Example 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 email
Example 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.