# Search opportunities

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /opportunities_search:
    get:
      summary: Search opportunities
      deprecated: false
      description: >-
        Search and filter opportunities with optional smart matching when
        developer_id is provided
      tags:
        - Opportunities
        - Opportunities
      parameters:
        - name: type
          in: query
          description: >-
            Comma-separated types:
            hackathon,job,grant,scholarship,learning_resource,competition
          required: false
          schema:
            type: string
        - name: skills
          in: query
          description: Comma-separated skills to filter by
          required: false
          schema:
            type: string
        - name: experience_level
          in: query
          description: ''
          required: false
          schema:
            type: string
            enum:
              - beginner
              - intermediate
              - advanced
              - expert
        - name: location
          in: query
          description: ''
          required: false
          schema:
            type: string
        - name: remote_only
          in: query
          description: ''
          required: false
          schema:
            type: boolean
        - name: sort_by
          in: query
          description: ''
          required: false
          schema:
            type: string
            enum:
              - relevance
              - deadline
              - created_at
        - name: limit
          in: query
          description: ''
          required: false
          schema:
            type: integer
            default: 20
            maximum: 100
        - name: offset
          in: query
          description: ''
          required: false
          schema:
            type: integer
            default: 0
        - name: developer_id
          in: query
          description: Enables smart matching with match scores
          required: false
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
          headers: {}
          x-apidog-name: ''
      security: []
      x-apidog-folder: Opportunities
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1150986/apis/api-25474683-run
components:
  schemas:
    SearchResponse:
      type: object
      properties:
        success:
          type: boolean
        total_count:
          type: integer
        returned_count:
          type: integer
        offset:
          type: integer
        opportunities:
          type: array
          items:
            $ref: '#/components/schemas/Opportunity'
      x-apidog-orders:
        - success
        - total_count
        - returned_count
        - offset
        - opportunities
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    Opportunity:
      type: object
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
        type:
          type: string
          enum:
            - hackathon
            - job
            - grant
            - scholarship
            - learning_resource
            - competition
        description:
          type: string
        required_skills:
          type: array
          items:
            type: string
        experience_level_required:
          type: string
        category:
          type: array
          items:
            type: string
        location:
          type: string
        remote_eligible:
          type: boolean
        deadline:
          type: integer
        prize_pool:
          type: number
        application_url:
          type: string
        source:
          type: string
        view_count:
          type: integer
        created_at:
          type: integer
      x-apidog-orders:
        - id
        - title
        - type
        - description
        - required_skills
        - experience_level_required
        - category
        - location
        - remote_eligible
        - deadline
        - prize_pool
        - application_url
        - source
        - view_count
        - created_at
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://xmsx-hkkx-nz6p.n7e.xano.io/api:v1
    description: Production server
security: []

```