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

# Get an account's job postings

> What the account's job postings say: competitors and software in use, and projects relevant to what you sell.



## OpenAPI

````yaml /openapi.json get /accounts/{account_id}/job-postings
openapi: 3.1.0
info:
  title: Letterdrop Competitor Monitoring API
  version: 2.0.0
  license:
    name: Proprietary
    url: https://letterdrop.com/terms
  description: >-
    Read your workspace's Competitor Monitoring data: the accounts where people
    engaged your competitors, the contacts and signals behind each, their CRM
    context, your outreach, and the dashboard metrics.


    The API speaks the same language as the New Competitor Deal webhook (payload
    version v2): a field has the same name and the same values in both, so
    whatever you build on one reads the other.


    **Versioning.** The major version is in the path (/api/v2). Within v2
    changes are additive only (new optional fields, filters, endpoints), so
    ignore fields you do not recognise. The v1 competitor-monitoring endpoints
    keep working unchanged.


    **Rate limits.** Per workspace: 10 requests/second and 600/minute, plus 20
    uncached computations/minute (analytics count as 4). Cached reads
    (meta.cache = hit), including every later page of a list you already
    started, use no computation budget. Every response carries RateLimit-Limit /
    RateLimit-Remaining / RateLimit-Reset; a 429 carries Retry-After.


    **Freshness.** Results are cached for a few minutes (analytics and filter
    options a little longer); meta.data_as_of says when the data was computed.
    Signals are collected daily, so polling faster than every few minutes
    returns the same data.
servers:
  - url: https://api.letterdrop.com/api/v2
security: []
tags:
  - name: Accounts
    description: Companies with competitor signals, and what we know about each.
  - name: Contacts
    description: The people behind the signals.
  - name: Analytics
    description: The dashboard metrics, one endpoint each.
  - name: Filters
    description: Every key of every object, and how to select and filter on it.
externalDocs:
  description: Developer reference
  url: https://api.letterdrop.com/api/v2/docs
paths:
  /accounts/{account_id}/job-postings:
    get:
      tags:
        - Accounts
      summary: Get an account's job postings
      description: >-
        What the account's job postings say: competitors and software in use,
        and projects relevant to what you sell.
      operationId: getAccountJobPostings
      parameters:
        - name: account_id
          in: path
          required: true
          description: The account_id of an account, URL-encoded (domain%3Aacme.com).
          schema:
            type: string
        - name: include
          in: query
          required: false
          description: contact_info adds contact_work_email and contact_phone_number.
          schema:
            type: string
        - name: fields
          in: query
          required: false
          description: Comma-separated fields of each item to return; omit for all.
          schema:
            type: string
            maxLength: 4000
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    $ref: '#/components/schemas/JobPostings'
                  meta:
                    $ref: '#/components/schemas/Meta'
              example:
                data:
                  account_id: domain:acme.com
                  job_postings_status: complete
                  job_postings_count: 4
                  job_postings_latest_date: '2026-10-16'
                  competitors_mentioned:
                    - HubSpot
                  systems_in_use:
                    - HubSpot
                    - Salesforce
                  initiatives:
                    - Consolidating marketing automation onto one platform.
                  job_postings:
                    - job_title: Marketing Operations Manager
                      job_url: https://jobs.example.com/acme/marketing-ops-manager
                      job_posted_date: '2026-10-16'
                      competitors_mentioned:
                        - HubSpot
                      systems_in_use:
                        - HubSpot
                      initiatives: []
                meta:
                  api_version: '2'
                  data_as_of: '2026-11-02T09:36:28.016Z'
                  cache: hit
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/Unprocessable'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
        - WorkspaceKey: []
        - BearerAuth:
            - mcp.read
components:
  schemas:
    JobPostings:
      type: object
      description: What an account's job postings say.
      x-field-groups:
        - Account
        - Company
        - Competitor
      properties:
        account_id:
          type: string
          description: >-
            Stable id of the account, e.g. "domain:acme.com". Use it in
            /accounts/{account_id} paths (URL-encoded).
          x-group: Account
        job_postings_status:
          type: string
          description: complete, or pending while postings are still being read.
          x-group: Company
        job_postings_count:
          type: integer
          description: Postings read.
          x-group: Company
        job_postings_latest_date:
          type: string
          x-format: YYYY-MM-DD, or empty
          description: Newest posting.
          x-group: Company
        competitors_mentioned:
          type: array
          items:
            type: string
          description: Competitors named across the postings.
          x-group: Competitor
        systems_in_use:
          type: array
          items:
            type: string
          description: Software named across the postings.
          x-group: Company
        initiatives:
          type: array
          items:
            type: string
          description: Projects relevant to what you sell.
          x-group: Company
        job_postings:
          type: array
          items:
            $ref: '#/components/schemas/JobPosting'
          description: The postings, newest first.
          x-group: Company
    Meta:
      type: object
      required:
        - api_version
        - data_as_of
        - cache
      properties:
        api_version:
          type: string
          const: '2'
        data_as_of:
          type: string
          format: date-time
          description: >-
            When the data in this response was computed. Responses are cached
            for a few minutes; this tells you how fresh they are.
        cache:
          type: string
          enum:
            - hit
            - miss
            - shared
            - 'off'
          description: >-
            hit = served from cache; miss = computed for this request; shared =
            joined a computation already running for the same query.
    JobPosting:
      type: object
      description: One job posting.
      x-field-groups:
        - Company
        - Competitor
      properties:
        job_title:
          type: string
          description: Title of the posting.
          x-group: Company
        job_url:
          type: string
          description: Link to the posting.
          x-group: Company
        job_posted_date:
          type: string
          x-format: YYYY-MM-DD, or empty
          description: When it was posted.
          x-group: Company
        competitors_mentioned:
          type: array
          items:
            type: string
          description: Your competitors the posting names.
          x-group: Competitor
        systems_in_use:
          type: array
          items:
            type: string
          description: Software the posting says the company uses.
          x-group: Company
        initiatives:
          type: array
          items:
            type: string
          description: Projects the posting describes.
          x-group: Company
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - invalid_request
                - invalid_json
                - invalid_cursor
                - cursor_expired
                - unauthorized
                - forbidden
                - account_not_found
                - not_found
                - rate_limited
                - internal_error
            message:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
              description: 'For invalid_request: one entry per parameter that failed.'
  responses:
    Unauthorized:
      description: Missing or invalid credential.
      x-status: 401
      x-codes:
        - unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The credential lacks the mcp.read scope.
      x-status: 403
      x-codes:
        - forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: No such account in this workspace, or no such route.
      x-status: 404
      x-codes:
        - account_not_found
        - not_found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unprocessable:
      description: A parameter failed validation; details lists each one.
      x-status: 422
      x-codes:
        - invalid_request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    TooManyRequests:
      description: Rate limited; wait Retry-After seconds.
      x-status: 429
      x-codes:
        - rate_limited
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds to wait.
    ServerError:
      description: Our fault; retry, and contact support if it persists.
      x-status: 500
      x-codes:
        - internal_error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    WorkspaceKey:
      type: apiKey
      in: header
      name: api-key
    BearerAuth:
      type: http
      scheme: bearer

````

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