---
title: "Job postings count"
method: POST
path: "/v1/job-search/count"
tags: ["Search"]
---

# Job postings count

`POST /v1/job-search/count`

Get count of job postings matching search filters

<span>⚡ <strong>Rate limit:</strong> 120 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> 1 credit per request&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `searchParams` object, required — Job search filter parameters
    - `companies` union — Filter jobs by one type of company identifier with array values
      - object
        - `identifier` 'linkedinSlug', required
        - `value` string[], required — Array of LinkedIn company slugs (e.g., ['microsoft'])
      - object
        - `identifier` 'domain', required
        - `value` string[], required — Array of company domains (e.g., ['microsoft.com'])
      - object
        - `identifier` 'linkedinUrl', required
        - `value` string[], required — Array of LinkedIn company URLs, e.g., https://www.linkedin.com/company/microsoft/
      - object
        - `identifier` 'linkedinOrgID', required
        - `value` string[], required — Array of LinkedIn organization IDs (numeric strings), e.g., '1035' for Microsoft
    - `title` string[], nullable — Array of job titles for partial match (e.g., 'Software Engineer', 'Manager')
    - `isActive` 'true' | 'false' | 'no_preference' | 'null', nullable — Filter by job status: true=active, false=closed, no_preference=both
    - `postedAt` union — Filter by job posting date (supports relative and absolute dates)
      - object
        - `strategy` 'absolute', required
        - `range` object, nullable
          - `lowerBound` string, nullable
          - `upperBound` string, nullable
      - object
        - `strategy` 'relative', required
        - `window` union
          - object
            - `method` 'lastN', required
            - `period` 'day' | 'week' | 'month' | 'quarter' | 'year', required
            - `quantity` number, required
          - object
            - `method` 'within', required
            - `period` 'day' | 'week' | 'month' | 'quarter' | 'year', required
            - `lowerBound` number, nullable
            - `upperBound` number, nullable
          - object
            - `method` 'calendar', required
            - `which` 'current' | 'previous', required
            - `period` 'day' | 'week' | 'month' | 'quarter' | 'year', required
    - `numApplicants` object, nullable — Filter by number of applicants (range)
      - `lowerBound` integer, nullable
      - `upperBound` integer, nullable
    - `jobFunctions` string[], nullable — Array of job functions
    - `industries` string[], nullable — Array of industries
    - `annualSalaryUsd` object, nullable — Filter by annual salary range in USD
      - `lowerBound` integer, nullable
      - `upperBound` integer, nullable
    - `yearsOfExperience` object, nullable — Filter by years of experience required
      - `lowerBound` integer, nullable
      - `upperBound` integer, nullable
    - `jobLocationType` string[], nullable — Filter by work location type. Deprecated.
    - `employmentType` string[], nullable — Array of employment types (e.g., Full-time, Part-time, Contract, Internship)
    - `seniorityLevel` string[], nullable — Array of seniority levels (e.g., Entry level, Mid-Senior level, Director)
    - `countryOrRegionCode` string[], nullable — Array of country or region codes (e.g., USA, IND, X-ANGLOSPHERE)

## Response `200`

Default Response

- object
  - `output` object, required
    - `totalJobsFound` integer, required — Total number of jobs matching the search criteria
  - `chargeInfo` union, required
    - object — Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
  - `warnings` object[], nullable — Warnings about extraneous fields in request
    - `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required — Warning message
  - `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `429` — Default Response
- `500` — Default Response
- `503` — Default Response

---

[API](https://skmtc.net/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/versions/0c537984b99f/schema)