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

# /ctgoodjobs/companies/jobs

> List all live CTgoodjobs (Hong Kong job board) listings of one employer, addressed by employer id or employer URL, optionally narrowed by keyword. Returns job cards with id, url, title, employer (id, name, profile url, logo), publication and expiry timestamps, salary, experience range, highlights, job areas, work locations with coordinates and Chinese names, employment types, career levels and listing flags. An employer with no live listing returns 412.

**Price:** 1 credit

**⚠️ Common errors:** 412: Employer not found or currently running no listings



## OpenAPI

````yaml /openapi/jobs.json post /api/ctgoodjobs/companies/jobs
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/ctgoodjobs/companies/jobs:
    post:
      tags:
        - /ctgoodjobs
      summary: /ctgoodjobs/companies/jobs
      description: >-
        List all live CTgoodjobs (Hong Kong job board) listings of one employer,
        addressed by employer id or employer URL, optionally narrowed by
        keyword. Returns job cards with id, url, title, employer (id, name,
        profile url, logo), publication and expiry timestamps, salary,
        experience range, highlights, job areas, work locations with coordinates
        and Chinese names, employment types, career levels and listing flags. An
        employer with no live listing returns 412.


        **Price:** 1 credit


        **⚠️ Common errors:** 412: Employer not found or currently running no
        listings
      operationId: __api_ctgoodjobs_companies_jobs_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CtgoodjobsCompanyJobsPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CtgoodjobsJobCard'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CtgoodjobsCompanyJobsPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        company:
          type: string
          minLength: 1
        count:
          type: integer
          maximum: 3000
          minimum: 1
        keyword:
          type: string
          default: ''
        sort:
          $ref: '#/components/schemas/CtgoodjobsSortMode'
          default: '2'
      type: object
      required:
        - company
        - count
    CtgoodjobsJobCard:
      properties:
        '@type':
          type: string
          default: CtgoodjobsJobCard
        id:
          type: string
        url:
          type: string
        job_title:
          type: string
        company_id:
          anyOf:
            - type: string
            - type: 'null'
        company_name:
          anyOf:
            - type: string
            - type: 'null'
        company_url:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        published_at:
          anyOf:
            - type: integer
            - type: 'null'
        expires_at:
          anyOf:
            - type: integer
            - type: 'null'
        salary:
          anyOf:
            - $ref: '#/components/schemas/CtgoodjobsSalary'
            - type: 'null'
        experience_from:
          anyOf:
            - type: integer
            - type: 'null'
        experience_to:
          anyOf:
            - type: integer
            - type: 'null'
        highlights:
          items:
            type: string
          type: array
          default: []
        job_areas:
          items:
            $ref: '#/components/schemas/CtgoodjobsJobArea'
          type: array
          default: []
        locations:
          items:
            $ref: '#/components/schemas/CtgoodjobsJobLocation'
          type: array
          default: []
        employment_types:
          items:
            $ref: '#/components/schemas/CtgoodjobsTaxonomyItem'
          type: array
          default: []
        career_levels:
          items:
            $ref: '#/components/schemas/CtgoodjobsTaxonomyItem'
          type: array
          default: []
        is_promoted:
          anyOf:
            - type: boolean
            - type: 'null'
        is_boosted:
          anyOf:
            - type: boolean
            - type: 'null'
        is_featured:
          anyOf:
            - type: boolean
            - type: 'null'
        is_high_salary:
          anyOf:
            - type: boolean
            - type: 'null'
        is_fresh_grad:
          anyOf:
            - type: boolean
            - type: 'null'
        is_cv_optional:
          anyOf:
            - type: boolean
            - type: 'null'
        is_whatsapp_apply:
          anyOf:
            - type: boolean
            - type: 'null'
        is_ct_message:
          anyOf:
            - type: boolean
            - type: 'null'
        is_crawled:
          anyOf:
            - type: boolean
            - type: 'null'
      type: object
      required:
        - id
        - url
        - job_title
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    CtgoodjobsSortMode:
      type: string
      enum:
        - '1'
        - '2'
    CtgoodjobsSalary:
      properties:
        '@type':
          type: string
          default: CtgoodjobsSalary
        display:
          anyOf:
            - type: string
            - type: 'null'
        min:
          anyOf:
            - type: number
            - type: 'null'
        max:
          anyOf:
            - type: number
            - type: 'null'
        currency:
          anyOf:
            - type: string
            - type: 'null'
        unit:
          anyOf:
            - type: string
            - type: 'null'
        is_negotiable:
          anyOf:
            - type: boolean
            - type: 'null'
        has_commission:
          anyOf:
            - type: boolean
            - type: 'null'
      type: object
    CtgoodjobsJobArea:
      properties:
        '@type':
          type: string
          default: CtgoodjobsJobArea
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          type: string
        function:
          anyOf:
            - type: string
            - type: 'null'
        area:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        function_url:
          anyOf:
            - type: string
            - type: 'null'
        skill_tag_path:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - name
    CtgoodjobsJobLocation:
      properties:
        '@type':
          type: string
          default: CtgoodjobsJobLocation
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          type: string
        name_zh:
          anyOf:
            - type: string
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
      type: object
      required:
        - name
    CtgoodjobsTaxonomyItem:
      properties:
        '@type':
          type: string
          default: CtgoodjobsTaxonomyItem
        id:
          anyOf:
            - type: string
            - type: 'null'
        name:
          type: string
        url:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - name
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````