> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seekout.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search



## OpenAPI

````yaml /partner-api/openapi.json post /api/ConversationalSearch/Search
openapi: 3.0.1
info:
  title: SeekOut Partner API
  version: '1.0'
  description: >-
    The SeekOut Partner API provides direct, programmatic REST access to
    SeekOut's talent search engine. Use it to build custom integrations,
    dashboards, scheduled jobs, and backend workflows for candidate search,
    profile matching, contact retrieval, and analytics. Authenticate every
    request with your `Api-Key` header, provisioned by your SeekOut
    representative.
servers:
  - url: https://partnerapi.seekout.io
    description: SeekOut Partner API
security:
  - ApiKey: []
paths:
  /api/ConversationalSearch/Search:
    post:
      tags:
        - ConversationalSearch
      summary: Search
      operationId: search
      parameters:
        - name: top
          in: query
          schema:
            type: integer
            format: int32
            default: 10
        - name: skip
          in: query
          schema:
            type: integer
            format: int32
            default: 0
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: >-
                #/components/schemas/PartnerApiWebService.Models.PartnerConversationalSearchRequest
          application/json:
            schema:
              $ref: >-
                #/components/schemas/PartnerApiWebService.Models.PartnerConversationalSearchRequest
          text/json:
            schema:
              $ref: >-
                #/components/schemas/PartnerApiWebService.Models.PartnerConversationalSearchRequest
          application/*+json:
            schema:
              $ref: >-
                #/components/schemas/PartnerApiWebService.Models.PartnerConversationalSearchRequest
      responses:
        '200':
          description: Success
components:
  schemas:
    PartnerApiWebService.Models.PartnerConversationalSearchRequest:
      type: object
      properties:
        conversation_id:
          type: string
          nullable: true
        user_input:
          type: string
          nullable: true
        current_query:
          nullable: true
          type: object
        transaction_id:
          type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: Api-Key
      description: >-
        Organization-scoped API key provisioned by SeekOut. Send it in the
        `Api-Key` header on every request.

````