MetricDuck Sectors API

The sectors API from MetricDuck — 6 operation(s) for sectors.

GitHub OpenAPI

Operations 6

GET /api/v1/taxonomy Get Taxonomy #
GET /api/v1/sectors Get Sectors #
GET /api/v1/industries Get Industries #
GET /api/v1/company/{cik}/sector Get Company Sector #
GET /api/v1/sectors/counts Get Sectors With Counts #
GET /api/v1/industries/counts Get Industries With Counts #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/metricduck-com:metricduck-com-sectors-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

metricduck-com-sectors-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Metric Duck Sectors API
  description: 'SEC filing data API: equity fundamentals updated daily from SEC EDGAR'
  version: 2.0.0
tags:
- name: sectors
paths:
  /api/v1/taxonomy:
    get:
      tags:
      - sectors
      summary: Get Taxonomy
      description: 'Get complete sector → industry taxonomy hierarchy.


        Returns the authoritative sector/industry classification structure.

        Frontend should cache this response (24 hours recommended).


        This is the single source of truth for sector/industry data.

        Use this instead of hardcoded frontend configs.


        Returns:

        Hierarchical taxonomy with sectors containing their industries'
      operationId: get_taxonomy_api_v1_taxonomy_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaxonomyResponse'
  /api/v1/sectors:
    get:
      tags:
      - sectors
      summary: Get Sectors
      description: 'Get all available sectors.


        Returns list of 11 major sectors for screener filtering.


        Returns:

        List of sectors with code and name'
      operationId: get_sectors_api_v1_sectors_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/SectorResponse'
                type: array
                title: Response Get Sectors Api V1 Sectors Get
  /api/v1/industries:
    get:
      tags:
      - sectors
      summary: Get Industries
      description: 'Get all industries, optionally filtered by sector.


        Args:

        sector_code: Optional sector code to filter industries (e.g., "TECH")


        Returns:

        List of industries with code, name, and parent sector'
      operationId: get_industries_api_v1_industries_get
      parameters:
      - name: sector_code
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by sector code
          title: Sector Code
        description: Filter by sector code
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/IndustryResponse'
                title: Response Get Industries Api V1 Industries Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/company/{cik}/sector:
    get:
      tags:
      - sectors
      summary: Get Company Sector
      description: 'Get sector classification for a specific company.


        Args:

        cik: Company CIK (10-digit identifier)


        Returns:

        Company sector/industry classification with confidence score


        Raises:

        HTTPException: 404 if company not found or classification unavailable'
      operationId: get_company_sector_api_v1_company__cik__sector_get
      parameters:
      - name: cik
        in: path
        required: true
        schema:
          type: string
          title: Cik
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanySectorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/sectors/counts:
    get:
      tags:
      - sectors
      summary: Get Sectors With Counts
      description: 'Get all available sectors with company counts.


        Queries companies to count how many companies exist in each sector.

        Useful for UX to show/hide empty sectors and display availability.


        Performance optimized: Uses single GROUP BY query instead of N separate queries.


        Returns:

        List of sectors with code, name, and company count'
      operationId: get_sectors_with_counts_api_v1_sectors_counts_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/SectorWithCountResponse'
                type: array
                title: Response Get Sectors With Counts Api V1 Sectors Counts Get
  /api/v1/industries/counts:
    get:
      tags:
      - sectors
      summary: Get Industries With Counts
      description: 'Get all industries with company counts, optionally filtered by sector.


        Queries companies to count how many companies exist in each industry.

        Useful for UX to show/hide empty industries and display availability.


        Args:

        sector_code: Optional sector code to filter industries (e.g., "TECH")


        Returns:

        List of industries with code, name, sector, and company count'
      operationId: get_industries_with_counts_api_v1_industries_counts_get
      parameters:
      - name: sector_code
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by sector code
          title: Sector Code
        description: Filter by sector code
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/IndustryWithCountResponse'
                title: Response Get Industries With Counts Api V1 Industries Counts Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    IndustryWithCountResponse:
      properties:
        industry_code:
          type: string
          title: Industry Code
        industry_name:
          type: string
          title: Industry Name
        sector_code:
          type: string
          title: Sector Code
        company_count:
          type: integer
          title: Company Count
      type: object
      required:
      - industry_code
      - industry_name
      - sector_code
      - company_count
      title: IndustryWithCountResponse
      description: Industry information with company count
    IndustryResponse:
      properties:
        industry_code:
          type: string
          title: Industry Code
        industry_name:
          type: string
          title: Industry Name
        sector_code:
          type: string
          title: Sector Code
      type: object
      required:
      - industry_code
      - industry_name
      - sector_code
      title: IndustryResponse
      description: Industry information
    SectorWithCountResponse:
      properties:
        sector_code:
          type: string
          title: Sector Code
        sector_name:
          type: string
          title: Sector Name
        company_count:
          type: integer
          title: Company Count
      type: object
      required:
      - sector_code
      - sector_name
      - company_count
      title: SectorWithCountResponse
      description: Sector information with company count
    SectorResponse:
      properties:
        sector_code:
          type: string
          title: Sector Code
        sector_name:
          type: string
          title: Sector Name
      type: object
      required:
      - sector_code
      - sector_name
      title: SectorResponse
      description: Sector information
    CompanySectorResponse:
      properties:
        cik:
          type: string
          title: Cik
        sector:
          type: string
          title: Sector
        sector_code:
          type: string
          title: Sector Code
        industry:
          type: string
          title: Industry
        industry_code:
          type: string
          title: Industry Code
        confidence:
          type: number
          title: Confidence
        source:
          type: string
          title: Source
      type: object
      required:
      - cik
      - sector
      - sector_code
      - industry
      - industry_code
      - confidence
      - source
      title: CompanySectorResponse
      description: Company sector classification
    TaxonomyResponse:
      properties:
        sectors:
          items:
            $ref: '#/components/schemas/SectorTaxonomyItem'
          type: array
          title: Sectors
        version:
          type: string
          title: Version
      type: object
      required:
      - sectors
      - version
      title: TaxonomyResponse
      description: Complete sector → industry taxonomy
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    IndustryTaxonomyItem:
      properties:
        code:
          type: string
          title: Code
        name:
          type: string
          title: Name
      type: object
      required:
      - code
      - name
      title: IndustryTaxonomyItem
      description: Industry in taxonomy hierarchy
    SectorTaxonomyItem:
      properties:
        code:
          type: string
          title: Code
        name:
          type: string
          title: Name
        industries:
          items:
            $ref: '#/components/schemas/IndustryTaxonomyItem'
          type: array
          title: Industries
      type: object
      required:
      - code
      - name
      - industries
      title: SectorTaxonomyItem
      description: Sector with its industries
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key