> ## Documentation Index > Fetch the complete documentation index at: https://socialquery.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # LinkedIn job hiring team > Return the publicly visible job-poster cards on a LinkedIn guest job page. This is not a complete recruiting organization or member-only hiring panel. Supply a numeric id or canonical HTTPS LinkedIn job URL; if both are present they must match. Unknown verification/follower fields remain null; IDs are public profile identifiers, not member URNs. A complete validated page without public poster cards returns an empty list at zero credits. No pagination, contact extraction, enrichment, or messaging. Costs **5 credits** for a successful live response containing a public job poster. A validated empty result, cache hit, successful idempotent replay, or error costs zero credits. Supply a numeric `id`, or a canonical HTTPS LinkedIn job `url` without tracking parameters or a fragment. If both are supplied, they must identify the same job. Pagination and extra query parameters are not accepted. This endpoint returns **public job-poster cards** from the guest job page. It does not enumerate the complete recruiting organization or the hiring panel shown to signed-in members. A complete job page without a public poster returns an empty list. A blocked, malformed, or mismatched job page fails instead of reporting an empty team. Each item contains an `author` with a public profile identifier, display name, headline (`bio`), profile URL, and an available source-hosted avatar URL. These identifiers are not member URNs. Follower counts and verification remain `null`; image URLs may expire. No profile enrichment, contact extraction, or messaging takes place. LinkedIn's anonymous page is the primary source. A bounded Oxylabs transport can retrieve that same page when the primary fails. This fallback shares the account's existing verification allowance with other Oxylabs routes; it is not an unlimited production plan. Availability depends on the source and remaining allowance. ## OpenAPI ````yaml GET /linkedin/job/hiring-team openapi: 3.1.0 info: title: SocialQuery API version: '2026-10-09' description: >- Documented requests for public-source records. Inspect accepted inputs and credit amounts, then verify the selected operation before integrating preview coverage. servers: - url: https://socialquery.dev/v1 security: - apiKey: [] paths: /linkedin/job/hiring-team: get: tags: - LinkedIn summary: LinkedIn Job Hiring Team description: >- Return the publicly visible job-poster cards on a LinkedIn guest job page. This is not a complete recruiting organization or member-only hiring panel. Supply a numeric id or canonical HTTPS LinkedIn job URL; if both are present they must match. Unknown verification/follower fields remain null; IDs are public profile identifiers, not member URNs. A complete validated page without public poster cards returns an empty list at zero credits. No pagination, contact extraction, enrichment, or messaging. operationId: get_linkedin_job_hiring_team parameters: - name: id in: query required: false example: '4432906054' schema: type: string pattern: ^[1-9][0-9]{0,19}$ - name: url in: query required: false schema: type: string format: uri description: >- Canonical https://www.linkedin.com/jobs/view/ or /jobs/view/- without query parameters, credentials or fragment. - name: Cache-Control in: header required: false example: no-cache schema: type: string - name: Idempotency-Key in: header required: false example: 7a5e1b4c-2d8f-4a3b-9c1e-6e8b4d2a1f3c schema: type: string - name: X-Max-Credits in: header required: false description: >- Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero. schema: type: integer minimum: 0 responses: '200': description: >- Return the publicly visible job-poster cards on a LinkedIn guest job page. This is not a complete recruiting organization or member-only hiring panel. Supply a numeric id or canonical HTTPS LinkedIn job URL; if both are present they must match. Unknown verification/follower fields remain null; IDs are public profile identifiers, not member URNs. A complete validated page without public poster cards returns an empty list at zero credits. No pagination, contact extraction, enrichment, or messaging. content: application/json: schema: allOf: - $ref: '#/components/schemas/SocialQueryResponse' - type: object properties: data: type: object properties: items: type: array maxItems: 20 items: type: object properties: author: type: object properties: id: type: string username: type: string display_name: type: string bio: type: - string - 'null' url: type: string format: uri avatar_url: type: - string - 'null' format: uri verified: type: 'null' followers: type: 'null' following: type: 'null' ext: type: object properties: id_kind: type: string const: public_identifier role: type: string const: job_poster source_job_id: type: string required: - id_kind - role - source_job_id additionalProperties: false required: - id - username - display_name - bio - url - avatar_url - verified - followers - following - ext additionalProperties: false required: - author additionalProperties: false returned_count: type: integer minimum: 0 total: type: integer minimum: 0 next_cursor: type: 'null' dropped: type: integer const: 0 job_id: type: string job_url: type: string format: uri source: type: string coverage_note: type: string required: - items - returned_count - total - next_cursor - dropped - job_id - job_url - source - coverage_note additionalProperties: false required: - data '400': $ref: '#/components/responses/Error400' '401': $ref: '#/components/responses/Error401' '402': $ref: '#/components/responses/Error402' '403': $ref: '#/components/responses/Error403' '404': $ref: '#/components/responses/Error404' '405': $ref: '#/components/responses/Error405' '409': $ref: '#/components/responses/Error409' '422': $ref: '#/components/responses/Error422' '429': $ref: '#/components/responses/Error429' '500': $ref: '#/components/responses/Error500' '502': $ref: '#/components/responses/Error502' '503': $ref: '#/components/responses/Error503' '504': $ref: '#/components/responses/Error504' components: schemas: SocialQueryResponse: type: object required: - success - platform - endpoint - credits_used - credits_remaining - request_id - cached - data properties: success: type: boolean const: true platform: type: string endpoint: type: string credits_used: type: integer minimum: 0 credits_remaining: type: - integer - 'null' request_id: type: string cached: type: boolean data: type: object additionalProperties: true description: >- The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null. SocialQueryError: type: object required: - success - platform - endpoint - credits_used - credits_remaining - request_id - cached - error properties: success: type: boolean const: false platform: type: string endpoint: type: string credits_used: type: integer minimum: 0 credits_remaining: type: - integer - 'null' request_id: type: string cached: type: boolean error: type: object required: - code - type - message - status - doc_url properties: code: type: string type: type: string message: type: string status: type: integer doc_url: type: string format: uri responses: Error400: description: Upstream rejected the request. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error401: description: Missing, expired, invalid, or revoked API key. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error402: description: Insufficient SocialQuery credits. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error403: description: Key scope or provider policy denied access. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error404: description: Endpoint or upstream resource not found. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error405: description: HTTP method is not supported. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error409: description: Idempotency conflict or request in progress. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error422: description: Invalid parameters. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error429: description: Request limit reached. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error500: description: Request processing failed. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error502: description: Upstream service failed. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error503: description: Provider or required service is unavailable. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' Error504: description: Upstream service timed out. headers: X-Request-Id: schema: type: string X-Credits-Used: schema: type: integer X-Credits-Remaining: schema: type: string X-Cache: schema: type: string enum: - HIT - MISS - BYPASS content: application/json: schema: $ref: '#/components/schemas/SocialQueryError' securitySchemes: apiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.