timzinin-com Job Posting To Hiring Manager Email API

openapi: 3.2.0
info:
  title: Zinin M2M Hub Job Posting To Hiring Manager Email API
  description: Pay-per-call data & tool APIs
  version: 1.0.0
  x-guidance: 'Zinin M2M Hub — pay-per-call data & tool APIs for AI agents. Each POST /api/{slug} operation below is a distinct paid tool: call GET /api/{slug}/schema first for the exact input shape, then POST with a signed PAYMENT-SIGNATURE header (x402 v2, USDC — see x-payment-info per operation) or omit it to receive a 402 with full payment requirements in the PAYMENT-REQUIRED header. The same catalog is also available as MCP JSON-RPC tool bundles at POST /mcp/{bundle} — see GET /.well-known/x402 for the list of bundles.'
tags:
- name: Job Posting To Hiring Manager Email
paths:
  /api/job-posting-to-hiring-manager-email:
    post:
      summary: Job Posting to Hiring Manager Email
      description: Turn a Greenhouse or Lever vacancy into the named hiring owner behind it, with a provider-verified work address from your own BYOK enrichment key. You pay $0.02 only for a verified hiring contact; ambiguous company matches, unsupported boards and empty results are free.
      operationId: call_job_posting_to_hiring_manager_email
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020000'
        protocols:
        - x402: {}
        network: eip155:8453
        payTo: '0x409D32aD39C02BC9B23a8b2d447532ed801b12dE'
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              title: Job Posting to Hiring Manager Email input
              description: Vacancies to resolve to the person who owns hiring for them. The Actor reads public ATS boards without a key, and returns an address only when your own contact-data provider confirms it. It never guesses a pattern and never tests a mailbox.
              type: object
              schemaVersion: 1
              additionalProperties: false
              properties:
                jobs:
                  title: Vacancies
                  type: array
                  description: One to 100 vacancies. Give either a direct ATS posting URL, or a company domain plus the exact job title.
                  editor: json
                  minItems: 1
                  maxItems: 100
                  items:
                    type: object
                    additionalProperties: false
                    properties:
                      jobUrl:
                        type: string
                        title: ATS posting URL
                        description: Direct posting link on a supported board, such as boards.greenhouse.io or jobs.lever.co. Board token and job identifier are parsed from the URL, never guessed.
                        minLength: 12
                        maxLength: 2048
                        pattern: "^https://[a-zA-Z0-9¡-\uFFFF][a-zA-Z0-9¡-\uFFFF.-]{0,252}/\\S*$"
                      companyDomain:
                        type: string
                        title: Company domain
                        description: Bare public company hostname such as example.com. Used to probe supported boards for that company; schemes, paths, credentials and IP literals are rejected.
                        minLength: 4
                        maxLength: 253
                        pattern: "^(?=.{4,253}$)(?:[a-zA-Z0-9¡-\uFFFF](?:[a-zA-Z0-9¡-\uFFFF-]{0,61}[a-zA-Z0-9¡-\uFFFF])?\\.)+[a-zA-Z¡-\uFFFF](?:[a-zA-Z0-9¡-\uFFFF-]{0,61}[a-zA-Z0-9¡-\uFFFF])?$"
                      jobTitle:
                        type: string
                        title: Exact job title
                        description: The vacancy title as the board publishes it. Required together with a company domain; matching is exact after whitespace and case normalization, never fuzzy.
                        minLength: 2
                        maxLength: 200
                      location:
                        type: string
                        title: Location
                        description: Optional location used only to disambiguate two vacancies sharing one title, never to invent a match.
                        maxLength: 200
                      department:
                        type: string
                        title: Department
                        description: Optional department used only to disambiguate and to rank role relevance, never to invent a match.
                        maxLength: 200
                      inputRef:
                        type: string
                        title: Caller reference
                        description: Optional opaque CRM or workflow reference copied to the result row exactly, including leading, trailing, repeated, and tab whitespace.
                        maxLength: 200
                  prefill:
                  - companyDomain: stripe.com
                    jobTitle: Account Executive, Bridge
                providerName:
                  title: Contact-data provider
                  type: string
                  description: Which provider your key belongs to. Only meaningful together with a provider API key.
                  enum:
                  - hunter
                  - apollo
                  - prospeo
                  - snov
                  - rocketreach
                  enumTitles:
                  - Hunter
                  - Apollo
                  - Prospeo
                  - Snov.io
                  - RocketReach
                providerApiKey:
                  title: Your provider API key
                  type: string
                  description: Your own key, used on your own quota. It is never stored, never logged, never reused across runs and never redistributed. Without it, no owner lookup is attempted and the vacancy returns free.
                  editor: textfield
                  isSecret: true
                maxConcurrency:
                  title: Maximum concurrency
                  type: integer
                  description: Vacancies processed concurrently only in local non-monetized runs. On-platform source work and paid delivery are sequential, and Lever pacing stays at one request per second regardless of this value.
                  default: 1
                  minimum: 1
                  maximum: 5
              required:
              - jobs
      responses:
        '200':
          description: Actor run succeeded and payment settled
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                    description: Actor output items — shape is actor-specific (varies per tool); see this operation's own requestBody schema/description for what the underlying actor produces.
                  meta:
                    type: object
                    properties:
                      run_ms:
                        type: integer
                        description: Actor run duration in milliseconds
                      item_count:
                        type: integer
                        description: len(results)
                      settled:
                        type: boolean
                        description: Whether the x402 payment was confirmed settled by the facilitator
                      transaction:
                        type:
                        - string
                        - 'null'
                        description: On-chain settlement transaction hash, null if unsettled
                    required:
                    - run_ms
                    - item_count
                    - settled
                    - transaction
                required:
                - results
                - meta
        '400':
          description: Malformed PAYMENT-SIGNATURE header or request body
        '402':
          description: Payment required or invalid — see PAYMENT-REQUIRED header
        '409':
          description: Payment payload already used
        '502':
          description: Actor run failed
        '504':
          description: Actor run timed out
      tags:
      - Job Posting To Hiring Manager Email