Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Zinin M2M Hub Tap Az Baku 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: Tap Az Baku
paths:
/api/tap-az-baku:
post:
summary: Tap.az Azerbaijan Real Estate Listings
description: Pull live apartment listings straight from Tap.az — Azerbaijan's biggest classifieds marketplace — by real-estate category. No login, no browser, no proxies.
operationId: call_tap_az_baku
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: Tap.az Listings input
type: object
schemaVersion: 1
properties:
category:
title: Category
type: string
description: Tap.az real-estate category path segment, appended to https://tap.az/elanlar/dasinmaz-emlak/. Only "menziller" (apartments) has been verified against this Actor — other values are not guaranteed to parse correctly.
editor: textfield
default: menziller
prefill: menziller
max_items:
title: Max results
type: integer
description: Maximum number of listing rows to return in this run.
default: 100
prefill: 5
minimum: 1
maximum: 2000
max_pages:
title: Max pages
type: integer
description: How many result pages to walk before stopping.
default: 3
prefill: 1
minimum: 1
maximum: 20
required:
- category
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:
- Tap Az Baku