> ## Documentation Index > Fetch the complete documentation index at: https://docs.bridgly.app/llms.txt > Use this file to discover all available pages before exploring further. # Fetch a LinkedIn job posting by URL ## OpenAPI ````yaml /openapi.json post /linkedin/get-job openapi: 3.1.0 info: title: Bridgly API description: >- Web scraping API for LinkedIn, X (Twitter) and Reddit. Authenticated endpoints accept a Bridgly API key (`bgly_…`) via `Authorization: Bearer `. version: 1.0.0 servers: - url: https://api.bridgly.app description: Production security: [] tags: - name: LinkedIn description: Scrape LinkedIn profiles, companies, posts, and search. - name: Reddit description: Scrape Reddit posts, subreddits, users, and search. - name: X (Twitter) description: Scrape tweets and search X. paths: /linkedin/get-job: post: tags: - LinkedIn summary: Fetch a LinkedIn job posting by URL requestBody: required: true content: application/json: schema: type: object properties: jobUrl: type: string description: >- The LinkedIn job posting URL — the numeric job id is parsed from it, e.g. "https://www.linkedin.com/jobs/view/4417164255/". required: - jobUrl responses: '200': description: Default Response content: application/json: schema: type: object properties: timeMs: type: number description: >- Wall-clock time the request took to complete, in milliseconds. creditsCost: type: number description: Number of account credits this request consumed. data: type: object properties: jobId: anyOf: - type: string - type: 'null' description: Numeric job id parsed from the URL, e.g. "4417164255". jobUrn: anyOf: - type: string - type: 'null' description: >- Job posting URN, e.g. "urn:li:fs_normalized_jobPosting:". dashJobUrn: anyOf: - type: string - type: 'null' description: >- Newer "dash" job posting URN, e.g. "urn:li:fsd_jobPosting:". jobUrl: anyOf: - type: string - type: 'null' description: >- Canonical job posting URL, e.g. "https://www.linkedin.com/jobs/view//". applyUrl: anyOf: - type: string - type: 'null' description: >- Offsite application URL when the posting applies on the employer site. title: anyOf: - type: string - type: 'null' description: Job title. standardizedTitleUrn: anyOf: - type: string - type: 'null' description: Standardized title URN, e.g. "urn:li:fs_title:5115". standardizedTitleId: anyOf: - type: string - type: 'null' description: >- Numeric standardized title id parsed from the title URN. standardizedTitleName: anyOf: - type: string - type: 'null' description: >- Standardized title label, e.g. "Undergraduate Student". description: anyOf: - type: string - type: 'null' description: Full job description as plain text. location: anyOf: - type: string - type: 'null' description: Formatted job location, e.g. "San Francisco, CA". geoUrn: anyOf: - type: string - type: 'null' description: Location geo URN, e.g. "urn:li:fs_geo:106411676". geoId: anyOf: - type: string - type: 'null' description: Numeric geo id parsed from the location URN. countryUrn: anyOf: - type: string - type: 'null' description: Country URN, e.g. "urn:li:fs_country:us". countryCode: anyOf: - type: string - type: 'null' description: >- ISO country code parsed from the country URN, e.g. "us". workRemoteAllowed: anyOf: - type: boolean - type: 'null' description: Whether the posting permits fully-remote work. experienceLevel: anyOf: - type: string - type: 'null' description: >- Formatted experience level, e.g. "Entry level", when exposed. employmentType: anyOf: - type: string - type: 'null' description: Employment type label, e.g. "Full-time". employmentTypeUrn: anyOf: - type: string - type: 'null' description: >- Employment status URN, e.g. "urn:li:fs_employmentStatus:FULL_TIME". employmentTypeCode: anyOf: - type: string - type: 'null' description: >- Employment status code parsed from the URN, e.g. "FULL_TIME". industries: type: array items: type: object properties: industryId: anyOf: - type: string - type: 'null' description: Numeric LinkedIn industry id, e.g. "70". name: anyOf: - type: string - type: 'null' description: Industry display name, e.g. "Research Services". required: - industryId - name additionalProperties: false description: >- Industries this posting is classified under, with stable ids. jobFunctions: type: array items: type: object properties: code: anyOf: - type: string - type: 'null' description: LinkedIn job-function code, e.g. "EDU". name: anyOf: - type: string - type: 'null' description: Job-function display name, e.g. "Education". required: - code - name additionalProperties: false description: Job functions for the posting, with their codes. inferredBenefits: type: array items: type: string description: Benefits inferred from the posting, e.g. "401(k)". jobState: anyOf: - type: string - type: 'null' description: Posting lifecycle state, e.g. "LISTED" or "CLOSED". sourceDomain: anyOf: - type: string - type: 'null' description: >- Employer domain the posting originated from, e.g. "lanl.jobs". listedAt: anyOf: - type: string - type: 'null' description: >- Listing date in ISO-8601 (UTC), from the posting's listedAt. listedAtEpochMs: anyOf: - type: number - type: 'null' description: Listing date as a Unix epoch in milliseconds. originalListedAt: anyOf: - type: string - type: 'null' description: Original listing date in ISO-8601 (UTC), if re-posted. originalListedAtEpochMs: anyOf: - type: number - type: 'null' description: Original listing date as a Unix epoch in milliseconds. expiresAt: anyOf: - type: string - type: 'null' description: >- Expiry date in ISO-8601 (UTC), when the posting closes. expiresAtEpochMs: anyOf: - type: number - type: 'null' description: Expiry date as a Unix epoch in milliseconds. closedAt: anyOf: - type: string - type: 'null' description: >- Close date in ISO-8601 (UTC) once the posting is closed. closedAtEpochMs: anyOf: - type: number - type: 'null' description: Close date as a Unix epoch in milliseconds. applies: anyOf: - type: number - type: 'null' description: Number of applications submitted, when exposed. views: anyOf: - type: number - type: 'null' description: >- Number of times the posting has been viewed, when exposed. companyName: anyOf: - type: string - type: 'null' description: Hiring company name. companyUrn: anyOf: - type: string - type: 'null' description: >- Hiring company URN, e.g. "urn:li:fs_normalized_company:". companyId: anyOf: - type: string - type: 'null' description: Numeric hiring-company id parsed from the company URN. companyUrl: anyOf: - type: string - type: 'null' description: Hiring company's LinkedIn page URL. companyUniversalName: anyOf: - type: string - type: 'null' description: >- Hiring company vanity slug, e.g. "los-alamos-national-laboratory". companyStaffCount: anyOf: - type: number - type: 'null' description: Hiring company employee count on LinkedIn. companyDescription: anyOf: - type: string - type: 'null' description: >- Hiring company's short description shown on the posting. companyLogoUrl: anyOf: - type: string - type: 'null' description: Hiring company logo URL. required: - jobId - jobUrn - dashJobUrn - jobUrl - applyUrl - title - standardizedTitleUrn - standardizedTitleId - standardizedTitleName - description - location - geoUrn - geoId - countryUrn - countryCode - workRemoteAllowed - experienceLevel - employmentType - employmentTypeUrn - employmentTypeCode - industries - jobFunctions - inferredBenefits - jobState - sourceDomain - listedAt - listedAtEpochMs - originalListedAt - originalListedAtEpochMs - expiresAt - expiresAtEpochMs - closedAt - closedAtEpochMs - applies - views - companyName - companyUrn - companyId - companyUrl - companyUniversalName - companyStaffCount - companyDescription - companyLogoUrl additionalProperties: false required: - timeMs - creditsCost - data additionalProperties: false '400': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false '401': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false '402': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false '500': description: Default Response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string description: Human-readable description of what went wrong. required: - status - message additionalProperties: false security: - bearerAuth: [] x-codeSamples: - lang: typescript label: Bridgly SDK source: |- import { Bridgly } from 'bridgly'; const client = new Bridgly({ apiKey: process.env.BRIDGLY_API_KEY }); const res = await client.linkedin.getJob({ jobUrl: "string", }); if (res.type === 'success') console.log(res.data); components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- A Bridgly API key (`bgly_…`). Metered endpoints deduct credits from the resolved account. ````