LinkedIn-Web-V2-API

搜索职位/Search jobs

Changed on

⚠️ 注意 / Note

本接口由有限的资源池提供服务,在高并发或资源紧张时可能间歇性返回 400 或其他错误。 此类失败通常是暂时性的,重试即可成功。建议客户端实现自动重试机制,推荐 retry = 3。

This endpoint is served from a limited resource pool and may intermittently return 400 or other errors under load. Such failures are typically transient and succeed on retry. We recommend implementing automatic retries with retry = 3.

[中文]

用途:

  • 按关键词与过滤条件搜索职位。

参数:

  • keywords: 搜索关键词。
  • geo_code: LinkedIn 地区码,默认 92000000(全球)。
  • date_posted / sort_by: 发布时间与排序方式。
  • experience_levels / company_ids / title_ids / onsite_remotes / functions / industries / job_types: 列表型过滤项,同名参数可重复传递多个值。
  • start: 翻页偏移,第 1 页传 0,第 2 页传 25,以此类推。

返回:

  • data: 职位列表(公司、标题、地点、薪资、发布时间等);total: 结果总数。

[English]

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.

[示例/Example]

keywords = "marketing", geo_code = 92000000, company_ids = 1035

get/api/v1/linkedin/web_v2/search_jobs

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Query parameters

keywordsstring nullable

关键词/Keywords

geo_codeinteger nullable

LinkedIn 地区码,92000000 为全球/LinkedIn geo code, 92000000 = worldwide

date_postedstring nullable

Any time / Past month / Past week / Past 24 hours

experience_levelsstring[] nullable

Internship / Entry level / Associate / Mid-Senior level / Director / Executive

company_idsinteger[] nullable

公司 ID,可重复传多个/Company ids, repeatable

title_idsinteger[] nullable

职位标题 ID,可重复传多个/Title ids, repeatable

onsite_remotesstring[] nullable

On-site / Remote / Hybrid

functionsstring[] nullable

职能过滤,可重复传多个/Functions, repeatable

industriesstring[] nullable

行业过滤,可重复传多个/Industries, repeatable

job_typesstring[] nullable

Full-time / Part-time / Contract / Temporary / Internship / Volunteer

sort_bystring nullable

Most relevant / Most recent

easy_applyboolean

仅 Easy Apply 职位/Easy-apply jobs only

under_10_applicantsboolean

仅申请人数少于 10 的职位/Under 10 applicants only

startinteger nullable

翻页偏移,第 1 页 0、第 2 页 25/Pagination offset

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes