timzinin-com Domain To Verified Work Email API

openapi: 3.2.0
info:
  title: Zinin M2M Hub Domain To Verified Work 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: Domain To Verified Work Email
paths:
  /api/domain-to-verified-work-email:
    post:
      summary: Domain to Verified Work Email
      description: Find the work email a named person publishes on their own company website, confirmed by a same-document schema.org Person assertion. No pattern guessing, no SMTP probing. $0.01 only when a published match is found; no-match, role mailbox, ambiguous and partial outcomes are free.
      operationId: call_domain_to_verified_work_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: Domain to Verified Work Email input
              description: People to match against literal emails on company websites that also publish an exact schema.org Person name-email assertion. The Actor never guesses patterns or tests a mailbox.
              type: object
              schemaVersion: 1
              additionalProperties: false
              properties:
                people:
                  title: People and company domains
                  type: array
                  description: One to 50 people. Each domain must be a bare public company hostname, not a URL.
                  editor: json
                  minItems: 1
                  maxItems: 50
                  items:
                    type: object
                    additionalProperties: false
                    properties:
                      fullName:
                        type: string
                        title: Full name
                        description: The person's real first and last name as it should appear on the company website.
                        minLength: 3
                        maxLength: 160
                        pattern: ^\s*\S+(?:\s+\S+)+\s*$
                      domain:
                        type: string
                        title: Company domain
                        description: Bare public company hostname such as example.com; 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])?$"
                      companyName:
                        type: string
                        title: Company name
                        description: Optional company name used as an additional page-evidence signal, never to invent an address.
                        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
                    required:
                    - fullName
                    - domain
                  prefill:
                  - fullName: King Lee
                    domain: visionwide.co
                    companyName: Visionwide
                maxPagesPerPerson:
                  title: Maximum pages per person
                  type: integer
                  description: 'Number of pages selected from the Actor-owned fixed order: /team, /about, /contact, then /.'
                  default: 3
                  minimum: 1
                  maximum: 4
                maxConcurrency:
                  title: Maximum concurrency
                  type: integer
                  description: People processed concurrently only in local non-monetized runs. On-platform source work and paid delivery are sequential.
                  default: 1
                  minimum: 1
                  maximum: 5
              required:
              - people
      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:
      - Domain To Verified Work Email