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

# Get job postings for a company

> Return job postings collected for the company since the given timestamp (default: last 30 days, max lookback: 90 days).

The company must be in Key Accounts — see [Add companies to Key Accounts](/api-reference/key-accounts/add-companies-to-key-accounts) to add one.



## OpenAPI

````yaml /reference/openapi.yaml get /v2/companies/{linkedin_id}/job-postings
openapi: 3.1.0
info:
  title: Tamtam Public API
  version: 2.0.0
servers:
  - url: https://api.tamtam.ai/api
security: []
paths:
  /v2/companies/{linkedin_id}/job-postings:
    get:
      tags:
        - Companies
      summary: Get job postings for a company
      description: >-
        Return job postings collected for the company since the given timestamp
        (default: last 30 days, max lookback: 90 days).


        The company must be in Key Accounts — see [Add companies to Key
        Accounts](/api-reference/key-accounts/add-companies-to-key-accounts) to
        add one.
      operationId: get-company-job-postings
      parameters:
        - description: >-
            LinkedIn numeric company ID.

            If you only have a name, domain or LinkedIn URL, resolve it first
            via [Search for a
            company](/api-reference/companies/search-for-a-company).
          in: path
          name: linkedin_id
          required: true
          schema:
            description: >-
              LinkedIn numeric company ID.

              If you only have a name, domain or LinkedIn URL, resolve it first
              via [Search for a
              company](/api-reference/companies/search-for-a-company).
            examples:
              - '104924588'
            type: string
        - description: >-
            Return job postings posted since this RFC3339 timestamp. Defaults to
            30 days ago. Max lookback is 90 days.
          explode: false
          in: query
          name: since
          schema:
            description: >-
              Return job postings posted since this RFC3339 timestamp. Defaults
              to 30 days ago. Max lookback is 90 days.
            examples:
              - '2025-05-01T00:00:00Z'
            format: date-time
            type: string
        - description: Maximum number of job postings to return.
          explode: false
          in: query
          name: limit
          schema:
            default: 50
            description: Maximum number of job postings to return.
            examples:
              - 50
            format: int32
            maximum: 200
            minimum: 1
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCompanyJobPostingsResponseDto'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      security:
        - apikeyAuth: []
        - bearerAuth: []
components:
  schemas:
    GetCompanyJobPostingsResponseDto:
      additionalProperties: false
      properties:
        job_postings:
          description: Job postings for the company, ordered by posting date descending.
          items:
            $ref: '#/components/schemas/CompanyJobPostingItemDto'
          type:
            - array
            - 'null'
      required:
        - job_postings
      type: object
    ErrorModel:
      additionalProperties: false
      properties:
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    CompanyJobPostingItemDto:
      additionalProperties: false
      properties:
        city:
          description: City where the role is based, when available.
          examples:
            - Paris
          type: string
        description:
          description: Full job description text, when available.
          type: string
        job_title:
          description: Job title
          examples:
            - Senior Backend Engineer
          type: string
        posted_at:
          description: Date the job was posted (UTC), when available.
          examples:
            - '2025-05-30T00:00:00Z'
          format: date-time
          type: string
        source_url:
          description: >-
            Link to the original job posting on the company's careers site or
            job board.
          examples:
            - https://jobs.example.com/listings/123
          type: string
        technologies:
          description: Technology slugs associated with the role.
          examples:
            - - python
              - kubernetes
          items:
            type: string
          type:
            - array
            - 'null'
      required:
        - job_title
        - source_url
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    apikeyAuth:
      description: Account API key passed in the Authorization header
      in: header
      name: Authorization
      type: apiKey
    bearerAuth:
      description: Bearer JWT obtained via the OAuth 2.1 authorization flow
      scheme: bearer
      type: http

````