timzinin-com Uk Public Tender Lead Alert API

openapi: 3.2.0
info:
  title: Zinin M2M Hub Uk Public Tender Lead Alert 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: Uk Public Tender Lead Alert
paths:
  /api/uk-public-tender-lead-alert:
    post:
      summary: UK Public Tender Lead Alert
      description: Watch UK Find a Tender for public-sector tenders newly matching your keywords, CPV codes, value threshold or region, and get only the new ones since your last check.
      operationId: call_uk_public_tender_lead_alert
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.050000'
        protocols:
        - x402: {}
        network: eip155:8453
        payTo: '0x409D32aD39C02BC9B23a8b2d447532ed801b12dE'
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              title: UK Public Tender Lead Alert input
              description: Watch UK Find a Tender for public-sector tenders newly matching your filter since your last check. At least one of keywords, cpvCodes, minValueGbp, maxValueGbp or region is required — an empty filter is rejected rather than treated as "show everything".
              type: object
              schemaVersion: 1
              additionalProperties: false
              properties:
                keywords:
                  title: Keywords
                  type: array
                  description: Case-insensitive substring match against the tender's title and description. 0-20 entries.
                  editor: stringList
                  maxItems: 20
                  prefill:
                  - software
                cpvCodes:
                  title: CPV codes / prefixes
                  type: array
                  description: Matched as a PREFIX against the tender's CPV classification code, e.g. "7211" matches "72110000". A full code with a check digit ("72000000-5") is accepted and the check digit is stripped automatically. 0-20 entries.
                  editor: stringList
                  maxItems: 20
                minValueGbp:
                  title: Minimum value (GBP)
                  type: integer
                  description: Only applied when the tender's published value is in GBP. A tender with a missing value, or a value published in another currency, is reported as a free, unbilled row instead of a silent guess — never excluded outright and never billed on an assumption.
                  minimum: 0
                maxValueGbp:
                  title: Maximum value (GBP)
                  type: integer
                  description: Same GBP-only caveat as minValueGbp above.
                  minimum: 0
                region:
                  title: Region (best-effort)
                  type: string
                  description: Case-insensitive substring match against whatever buyer/delivery region or country data the notice publishes. Not a hard filter guarantee — region data is not published on every notice, and an absent field never excludes a tender on this axis alone.
                  editor: textfield
                  maxLength: 200
                lookbackDays:
                  title: Lookback window (days)
                  type: integer
                  description: 'How far back each run looks for updated releases. Default 1 day: the measured rate limit (12 requests before HTTP 429) covers a full 24h window in about 6 paginated requests. A wider window is honored, but is more likely to exceed the request budget mid-run and finish with honest partial coverage for that run (nothing lost — anything not read this run is picked up, and billed, on a later run).'
                  default: 1
                  minimum: 1
                  maximum: 30
                maxNewPerRun:
                  title: Max new tenders per run
                  type: integer
                  description: Caps how many NEW matching tenders a single run delivers and charges for, even if more were found. Anything held back by this cap is never lost — it stays "new" and appears (and is billed) on a future run.
                  default: 20
                  minimum: 1
                  maximum: 200
                stateKey:
                  title: Watch name
                  type: string
                  description: A name for THIS watch, so you can run several independent tender watches from one Actor without one overwriting another's memory of what it has already billed. Scoped to your own Apify account. The prefilled value is only there so this Actor's own daily platform test has a stable, obviously-a-test name — replace it with your own watch name.
                  editor: textfield
                  isSecret: true
                  prefill: apify-daily-test
                emitBaseline:
                  title: Announce baseline creation
                  type: boolean
                  description: When true (default), the first run for a new watch name writes one free, clearly-labelled row summarizing what was captured as the reference point. When false, that first run still saves the reference point — it just writes no row, for buyers who only ever want to see "new since I subscribed" and never a first-run dump.
                  default: true
      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:
      - Uk Public Tender Lead Alert