Socket

Socket Dependencies API

Search and reverse-look-up dependencies across all of an organization's scanned repos. Find every project consuming a specific package and version, plus historical dependency-count trends used by Socket's analytics dashboards.

Socket Dependencies API is one of 15 APIs that Socket publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Dependencies, Search, and Reverse Lookup. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 Naftiko capability spec.

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.socket.dev/reference/searchdependencies

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/socket-dev/refs/heads/main/openapi/socket-dependencies-api-openapi.yml

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/socket-dev/refs/heads/main/capabilities/dependencies-search.yaml

OpenAPI Specification

socket-dependencies-api-openapi.yml Raw ↑ 
openapi: 3.0.0
info:
  description: Socket dependencies API endpoints.
  title: Socket Dependencies API
  version: '0'
servers:
- url: https://api.socket.dev/v0
paths:
  /dependencies/search:
    post:
      tags:
      - dependencies
      summary: Search dependencies
      operationId: searchDependencies
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                limit:
                  type: integer
                  description: ''
                  default: 50
                  minimum: 1
                  maximum: 100
                offset:
                  type: integer
                  description: ''
                  default: 0
                  minimum: 0
                purls:
                  type: array
                  items:
                    type: string
                    description: PURLs to filter results with
                    default: ''
                  description: ''
              required:
              - limit
              - offset
        required: false
      security:
      - bearerAuth: []
      - basicAuth: []
      description: 'Search for any dependency that is being used in your organization.


        This endpoint consumes 1 unit of your quota.


        This endpoint requires the following org token scopes:

        - No Scopes Required, but authentication is required'
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                description: ''
                properties:
                  end:
                    type: boolean
                    default: false
                    description: ''
                  limit:
                    type: integer
                    description: ''
                    default: 1000
                  offset:
                    type: integer
                    description: ''
                    default: 0
                  purlFilters:
                    type: object
                    additionalProperties: false
                    description: ''
                    properties:
                      valid:
                        type: array
                        items:
                          type: string
                          description: Successfully parsed PURLs
                          default: ''
                        description: ''
                      invalid:
                        type: array
                        items:
                          type: string
                          description: PURLs that could not be parsed
                          default: ''
                        description: ''
                    required:
                    - invalid
                    - valid
                  rows:
                    type: array
                    items:
                      type: object
                      additionalProperties: false
                      properties:
                        branch:
                          type: string
                          description: ''
                          default: ''
                        direct:
                          type: boolean
                          default: false
                          description: ''
                        id:
                          type: string
                          description: ''
                          default: ''
                        name:
                          type: string
                          description: ''
                          default: ''
                        repository:
                          type: string
                          description: ''
                          default: ''
                        type:
                          type: string
                          description: ''
                          default: ''
                        namespace:
                          type: string
                          description: ''
                          default: ''
                        version:
                          type: string
                          description: ''
                          default: ''
                        release:
                          type: string
                          description: ''
                          default: ''
                        workspace:
                          type: string
                          description: ''
                          default: ''
                      required:
                      - branch
                      - direct
                      - id
                      - name
                      - repository
                      - type
                    description: ''
                required:
                - end
                - limit
                - offset
                - purlFilters
                - rows
          description: Search dependencies response
        '400':
          $ref: '#/components/responses/SocketBadRequest'
        '401':
          $ref: '#/components/responses/SocketUnauthorized'
        '403':
          $ref: '#/components/responses/SocketForbidden'
        '404':
          $ref: '#/components/responses/SocketNotFoundResponse'
        '429':
          $ref: '#/components/responses/SocketTooManyRequestsResponse'
      x-readme: {}
  /orgs/{org_slug}/historical/dependencies/trend:
    get:
      tags:
      - dependencies
      summary: Trend of historical dependencies (Beta)
      operationId: historicalDependenciesTrend
      parameters:
      - name: org_slug
        in: path
        required: true
        description: The slug of the organization
        schema:
          type: string
      - name: date
        in: query
        required: false
        description: The UTC date in YYYY-MM-DD format for which to fetch dependencies
        schema:
          type: string
          default: CURRENT_DATE
      - name: range
        in: query
        required: false
        description: The number of days of data to fetch as an offset from input date
        schema:
          type: string
          default: -7d
      - name: repoFullName
        in: query
        required: false
        description: Comma-separated list of repo full names that should be included
        schema:
          type: string
      - name: repoSlug
        in: query
        required: false
        description: Comma-separated list of repo slugs that should be included
        schema:
          type: string
      - name: repoLabels
        in: query
        required: false
        description: Comma-separated list of repo labels that should be included
        schema:
          type: string
      - name: artifactType
        in: query
        required: false
        description: Comma-separated list of artifact types (e.g. "npm", "pypi", "gem", "maven", "golang", etc.) that should be included
        schema:
          type: string
      - name: dependencyDirect
        in: query
        required: false
        description: Direct/transitive dependency filter flag
        schema:
          type: boolean
          default: false
      - name: dependencyDev
        in: query
        required: false
        description: Development/production dependency filter flag
        schema:
          type: boolean
          default: false
      - name: dependencyDead
        in: query
        required: false
        description: Dead/reachable dependency filter flag
        schema:
          type: boolean
          default: false
      security:
      - bearerAuth:
        - historical:dependencies-trend
      - basicAuth:
        - historical:dependencies-trend
      description: 'Trend analytics of historical dependencies.


        This endpoint consumes 10 units of your quota.


        This endpoint requires the following org token scopes:

        - historical:dependencies-trend'
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                description: ''
                properties:
                  meta:
                    type: object
                    additionalProperties: false
                    description: ''
                    properties:
                      organizationId:
                        type: string
                        description: ''
                        default: ''
                      startDateInclusive:
                        type: string
                        description: ''
                        default: ''
                      endDateInclusive:
                        type: string
                        description: ''
                        default: ''
                      interval:
                        type: string
                        description: ''
                        default: ''
                      aggregation:
                        type: object
                        additionalProperties: false
                        description: ''
                        properties:
                          fields:
                            type: array
                            items:
                              type: string
                              description: ''
                              default: ''
                            description: ''
                          groups:
                            type: array
                            items:
                              type: array
                              items:
                                type: string
                                description: ''
                                default: ''
                              description: ''
                            description: ''
                        required:
                        - fields
                        - groups
                      filters:
                        type: object
                        additionalProperties: false
                        properties:
                          repoFullName:
                            type: array
                            items:
                              type: string
                              description: ''
                              default: ''
                            description: Comma-separated list of repo full names that should be included
                          repoSlug:
                            type: array
                            items:
                              type: string
                              description: ''
                              default: ''
                            description: Comma-separated list of repo slugs that should be included
                          repoLabels:
                            type: array
                            items:
                              type: string
                              description: ''
                              default: ''
                            description: Comma-separated list of repo labels that should be included
                          artifactType:
                            type: array
                            items:
                              type: string
                              description: ''
                              default: ''
                            description: Comma-separated list of artifact types (e.g. "npm", "pypi", "gem", "maven", "golang", etc.) that should be included
                          dependencyDirect:
                            type: array
                            items:
                              type: boolean
                              default: false
                              description: ''
                            description: Direct/transitive dependency filter flag
                          dependencyDev:
                            type: array
                            items:
                              type: boolean
                              default: false
                              description: ''
                            description: Development/production dependency filter flag
                          dependencyDead:
                            type: array
                            items:
                              type: boolean
                              default: false
                              description: ''
                            description: Dead/reachable dependency filter flag
                        description: ''
                    required:
                    - aggregation
                    - endDateInclusive
                    - filters
                    - interval
                    - organizationId
                    - startDateInclusive
                  items:
                    type: array
                    items:
                      type: object
                      additionalProperties: false
                      description: ''
                      properties:
                        date:
                          type: string
                          description: ''
                          default: ''
                        startOfDayTimestamp:
                          type: number
                          description: ''
                          default: 0
                        dataPoints:
                          type: array
                          items:
                            type: object
                            additionalProperties: false
                            description: ''
                            properties:
                              aggregationGroup:
                                type: array
                                items:
                                  type: string
                                  description: ''
                                  default: ''
                                description: ''
                              count:
                                type: integer
                                description: ''
                                default: 0
                              countDelta:
                                type: integer
                                description: ''
                                default: 0
                              countDirect:
                                type: integer
                                description: ''
                                default: 0
                              countDirectDelta:
                                type: integer
                                description: ''
                                default: 0
                              countIndirect:
                                type: integer
                                description: ''
                                default: 0
                              countIndirectDelta:
                                type: integer
                                description: ''
                                default: 0
                              countsBySeverity:
                                type: object
                                additionalProperties: false
                                description: ''
                                properties:
                                  low:
                                    type: object
                                    additionalProperties: false
                                    description: ''
                                    properties:
                                      count:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDirect:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDirectDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countIndirect:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countIndirectDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                    required:
                                    - count
                                    - countDelta
                                    - countDirect
                                    - countDirectDelta
                                    - countIndirect
                                    - countIndirectDelta
                                  medium:
                                    type: object
                                    additionalProperties: false
                                    description: ''
                                    properties:
                                      count:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDirect:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDirectDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countIndirect:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countIndirectDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                    required:
                                    - count
                                    - countDelta
                                    - countDirect
                                    - countDirectDelta
                                    - countIndirect
                                    - countIndirectDelta
                                  high:
                                    type: object
                                    additionalProperties: false
                                    description: ''
                                    properties:
                                      count:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDirect:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDirectDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countIndirect:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countIndirectDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                    required:
                                    - count
                                    - countDelta
                                    - countDirect
                                    - countDirectDelta
                                    - countIndirect
                                    - countIndirectDelta
                                  critical:
                                    type: object
                                    additionalProperties: false
                                    description: ''
                                    properties:
                                      count:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDirect:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countDirectDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countIndirect:
                                        type: integer
                                        description: ''
                                        default: 0
                                      countIndirectDelta:
                                        type: integer
                                        description: ''
                                        default: 0
                                    required:
                                    - count
                                    - countDelta
                                    - countDirect
                                    - countDirectDelta
                                    - countIndirect
                                    - countIndirectDelta
                                required:
                                - critical
                                - high
                                - low
                                - medium
                            required:
                            - aggregationGroup
                            - count
                            - countDelta
                            - countDirect
                            - countDirectDelta
                            - countIndirect
                            - countIndirectDelta
                            - countsBySeverity
                          description: ''
                      required:
                      - dataPoints
                      - date
                      - startOfDayTimestamp
                    description: ''
                required:
                - items
                - meta
          description: The trend data
        '400':
          $ref: '#/components/responses/SocketBadRequest'
        '401':
          $ref: '#/components/responses/SocketUnauthorized'
        '403':
          $ref: '#/components/responses/SocketForbidden'
        '404':
          $ref: '#/components/responses/SocketNotFoundResponse'
        '429':
          $ref: '#/components/responses/SocketTooManyRequestsResponse'
      x-readme: {}
components:
  requestBodies: {}
  responses:
    SocketBadRequest:
      content:
        application/json:
          schema:
            type: object
            additionalProperties: false
            description: ''
            properties:
              error:
                type: object
                additionalProperties: false
                description: ''
                properties:
                  message:
                    type: string
                    description: ''
                    default: ''
                  details:
                    type: object
                    description: ''
                    default: null
                    nullable: true
                required:
                - details
                - message
            required:
            - error
      description: Bad request
    SocketUnauthorized:
      content:
        application/json:
          schema:
            type: object
            additionalProperties: false
            description: ''
            properties:
              error:
                type: object
                additionalProperties: false
                description: ''
                properties:
                  message:
                    type: string
                    description: ''
                    default: ''
                  details:
                    type: object
                    description: ''
                    default: null
                    nullable: true
                required:
                - details
                - message
            required:
            - error
      description: Unauthorized
    SocketForbidden:
      content:
        application/json:
          schema:
            type: object
            additionalProperties: false
            description: ''
            properties:
              error:
                type: object
                additionalProperties: false
                description: ''
                properties:
                  message:
                    type: string
                    description: ''
                    default: ''
                  details:
                    type: object
                    description: ''
                    default: null
                    nullable: true
                required:
                - details
                - message
            required:
            - error
      description: Insufficient max_quota for API method
    SocketNotFoundResponse:
      content:
        application/json:
          schema:
            type: object
            additionalProperties: false
            description: ''
            properties:
              error:
                type: object
                additionalProperties: false
                description: ''
                properties:
                  message:
                    type: string
                    description: ''
                    default: ''
                  details:
                    type: object
                    description: ''
                    default: null
                    nullable: true
                required:
                - details
                - message
            required:
            - error
      description: Resource not found
    SocketTooManyRequestsResponse:
      description: Insufficient quota for API route
      headers:
        Retry-After:
          description: 'Retry contacting the endpoint *at least* after seconds.

            See https://tools.ietf.org/html/rfc7231#section-7.1.3'
          schema:
            format: int32
            type: integer
      content:
        application/json:
          schema:
            type: object
            additionalProperties: false
            description: ''
            properties:
              error:
                type: object
                additionalProperties: false
                description: ''
                properties:
                  message:
                    type: string
                    description: ''
                    default: ''
                  details:
                    type: object
                    description: ''
                    default: null
                    nullable: true
                required:
                - details
                - message
            required:
            - error
    SocketInternalServerError:
      content:
        application/json:
          schema:
            type: object
            additionalProperties: false
            description: ''
            properties:
              error:
                type: object
                additionalProperties: false
                description: ''
                properties:
                  message:
                    type: string
                    description: ''
                    default: ''
                  details:
                    type: object
                    description: ''
                    default: null
                    nullable: true
                required:
                - details
                - message
            required:
            - error
      description: Internal server error
    SocketConflict:
      content:
        application/json:
          schema:
            type: object
            additionalProperties: false
            description: ''
            properties:
              error:
                type: object
                additionalProperties: false
                description: ''
                properties:
                  message:
                    type: string
                    description: ''
                    default: ''
                  details:
                    type: object
                    description: ''
                    default: null
                    nullable: true
                required:
                - details
                - message
            required:
            - error
      description: Resource already exists
    SocketGone:
      content:
        application/json:
          schema:
            type: object
            additionalProperties: false
            description: ''
            properties:
              error:
                type: object
                additionalProperties: false
                description: ''
                properties:
                  message:
                    type: string
                    description: ''
                    default: ''
                  details:
                    type: object
                    description: ''
                    default: null
                    nullable: true
                required:
                - details
                - message
            required:
            - error
      description: Gone
  schemas: {}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Organization Tokens can be passed as a Bearer token
    basicAuth:
      type: http
      scheme: basic
      description: Organization Tokens can be passed as the user field in basic auth