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

# Search jobs

> Search jobs

Search jobs

**Pricing** — billed per successful call; the final charge scales by your plan multiplier. Charged only when the upstream response body `code` is `200`.

<Note>
  Response structure is not yet fully documented — **refer to the actual API response**.
</Note>

## Example

```bash theme={null}
curl "https://api.aisa.one/apis/v1/tikhub/linkedin/web_v2/search_jobs" \
  -H "Authorization: Bearer YOUR_API_KEY"
```


## OpenAPI

````yaml openapi/tikhub.json GET /tikhub/linkedin/web_v2/search_jobs
openapi: 3.0.0
info:
  title: TikHub API
  description: >-
    Multi-platform social media data — Douyin, TikTok, Bilibili, Kuaishou,
    Weibo, Xiaohongshu, Zhihu, and commercial (Xingtu/Huahuo/Billboard)
    endpoints.
  version: 1.0.0
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /tikhub/linkedin/web_v2/search_jobs:
    get:
      tags:
        - TikHub - Linkedin
      summary: Search jobs
      description: >-
        Linkedin (web_v2).


        ### Purpose:

        - Search jobs by keywords and filters.


        ### Parameters:

        - keywords: Search keywords.

        - geo_code: LinkedIn geo code. Defaults to 92000000 (worldwide).

        - date_posted / sort_by: Posting-time filter and sort order.

        - experience_levels / company_ids / title_ids / onsite_remotes /
        functions /
          industries / job_types: List filters — repeat the same parameter to pass
          multiple values.
        - start: Pagination offset — 0 for page 1, 25 for page 2, and so on.


        ### Returns:

        - data: list of jobs (company, title, location, salary, posted time, …);
          total: total number of results.
      operationId: get_tikhub_linkedin_web_v2_search_jobs
      parameters:
        - name: keywords
          in: query
          required: false
          schema:
            description: Keywords
            title: Keywords
            nullable: true
            type: string
          description: Keywords
          example: data analyst
        - name: geo_code
          in: query
          required: false
          schema:
            description: LinkedIn geo code, 92000000 = worldwide
            default: 92000000
            title: Geo Code
            nullable: true
            type: integer
          description: LinkedIn geo code, 92000000 = worldwide
        - name: date_posted
          in: query
          required: false
          schema:
            description: Any time / Past month / Past week / Past 24 hours
            title: Date Posted
            nullable: true
            type: string
          description: Any time / Past month / Past week / Past 24 hours
        - name: experience_levels
          in: query
          required: false
          schema:
            description: >-
              Internship / Entry level / Associate / Mid-Senior level / Director
              / Executive
            title: Experience Levels
            nullable: true
            type: array
            items:
              type: string
          description: >-
            Internship / Entry level / Associate / Mid-Senior level / Director /
            Executive
        - name: company_ids
          in: query
          required: false
          schema:
            description: Company ids, repeatable
            title: Company Ids
            nullable: true
            type: array
            items:
              type: integer
          description: Company ids, repeatable
        - name: title_ids
          in: query
          required: false
          schema:
            description: Title ids, repeatable
            title: Title Ids
            nullable: true
            type: array
            items:
              type: integer
          description: Title ids, repeatable
        - name: onsite_remotes
          in: query
          required: false
          schema:
            description: On-site / Remote / Hybrid
            title: Onsite Remotes
            nullable: true
            type: array
            items:
              type: string
          description: On-site / Remote / Hybrid
        - name: functions
          in: query
          required: false
          schema:
            description: Functions, repeatable
            title: Functions
            nullable: true
            type: array
            items:
              type: string
          description: Functions, repeatable
        - name: industries
          in: query
          required: false
          schema:
            description: Industries, repeatable
            title: Industries
            nullable: true
            type: array
            items:
              type: string
          description: Industries, repeatable
        - name: job_types
          in: query
          required: false
          schema:
            description: >-
              Full-time / Part-time / Contract / Temporary / Internship /
              Volunteer
            title: Job Types
            nullable: true
            type: array
            items:
              type: string
          description: >-
            Full-time / Part-time / Contract / Temporary / Internship /
            Volunteer
        - name: sort_by
          in: query
          required: false
          schema:
            description: Most relevant / Most recent
            title: Sort By
            nullable: true
            type: string
          description: Most relevant / Most recent
        - name: easy_apply
          in: query
          required: false
          schema:
            type: boolean
            description: Easy-apply jobs only
            default: false
            title: Easy Apply
          description: Easy-apply jobs only
        - name: under_10_applicants
          in: query
          required: false
          schema:
            type: boolean
            description: Under 10 applicants only
            default: false
            title: Under 10 Applicants
          description: Under 10 applicants only
        - name: start
          in: query
          required: false
          schema:
            description: Pagination offset — 0 for page 1, 25 for page 2, and so on.
            title: Start
            nullable: true
            type: integer
            minimum: 0
          description: Pagination offset — 0 for page 1, 25 for page 2, and so on.
      responses:
        '200':
          description: >-
            Successful response. The outer object follows `ResponseModel`; the
            endpoint-specific payload is in `data`.


            ### Returns

            - data: list of jobs (company, title, location, salary, posted time,
            …);
              total: total number of results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
components:
  schemas:
    ResponseModel:
      properties:
        code:
          type: integer
          title: Code
          description: HTTP status code
          default: 200
        request_id:
          title: Request Id
          description: Unique request identifier
          nullable: true
          type: string
        message:
          type: string
          title: Message
          description: Response message (EN-US)
          default: Request successful. This request will incur a charge.
        message_zh:
          type: string
          title: Message Zh
          description: Response message (ZH-CN)
          default: 请求成功，本次请求将被计费。
        support:
          type: string
          title: Support
          description: Support message
          default: 'Discord: https://discord.gg/aMEAS8Xsvz'
        time:
          type: string
          title: Time
          description: The time the response was generated
        time_stamp:
          type: integer
          title: Time Stamp
          description: The timestamp the response was generated
        time_zone:
          type: string
          title: Time Zone
          description: The timezone of the response time
          default: America/Los_Angeles
        docs:
          title: Docs
          description: Link to the API Swagger documentation for this endpoint
          nullable: true
          type: string
        cache_message:
          title: Cache Message
          description: Cache message (EN-US)
          default: >-
            This response is cached and accessible via the URL below for 24
            hours at no extra cost. The cache is for request tracing only — it
            doesn't affect the API's data freshness and won't be returned
            through the API again.
          nullable: true
          type: string
        cache_message_zh:
          title: Cache Message Zh
          description: Cache message (ZH-CN)
          default: >-
            本次响应已缓存，可通过下方 URL 直接查看，有效期 24
            小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。
          nullable: true
          type: string
        cache_url:
          title: Cache Url
          description: The URL to access the cached result
          nullable: true
          type: string
        router:
          type: string
          title: Router
          description: The endpoint that generated this response
          default: ''
        params:
          title: Params
          description: The parameters used in the request
          default: {}
        data:
          title: Data
          description: >-
            Endpoint-specific response payload. The official shared model does
            not declare a fixed type or field set. Use the operation's
            documented return fields or response example; an operation-specific
            schema, when present, describes the documented fields. Undocumented
            fields must be read from the actual response rather than assumed.
          nullable: true
      type: object
      title: ResponseModel
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.