# Sahibindex Property Market Benchmark

> Sahibindex Property Market Benchmark is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Benchmarks a Turkish residential property's asking price against the sahibindex aggregate market report for its city and period, returning a deviation score and below/above/at-market decision.

## Facts

- Endpoint: POST https://api.timzinin.com/api/sahibindex-property-market-benchmark
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sahibindex-property-market-benchmark-33f78f20
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jPsGCMsHzun-rj8Dn2eDi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sahibindex-property-market-benchmark-33f78f20 -d '<json body>'
```

Example prompt: Check if my Istanbul apartment listing at 5,500,000 TRY for 100 m² is above or below the sahibindex market benchmark for February 2026 — give me the deviation percentage and liquidity signal.

## When to prefer this

Use this endpoint when you need to benchmark a Turkish residential property's asking price against the official sahibindex (sahibinden.com + BETAM) aggregate market report for a specific city and month. Prefer this over generic AVM (automated valuation model) services when you specifically need sahibindex methodology, Turkish lira benchmarks, and traceable PDF source attribution for İstanbul, Ankara, or İzmir markets.

## Known failure modes

- City not covered by sahibindex report (only Türkiye aggregate, İstanbul, Ankara, İzmir supported)
- Report month has no available sahibindex PDF — stale or future dates return errors
- Invalid or missing property price/area inputs cause validation failure
- PDF source unavailable or SHA256 mismatch causes retrieval failure
- Low confidence result when subject price deviates marginally near threshold

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a JSON object with a market decision ('below_aggregate_market_review', 'above_aggregate_market_review', or at-market), percentage deviation from the sahibindex benchmark price, liquidity signal (normal/slow), confidence level, source PDF metadata including SHA256 and page count, reference month, supported cities, and a stable ID for the benchmark run. Also includes reasoning for the decision (freshness, liquidity days, threshold, comparison values).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "reportUrl": {
   "type": "string",
   "pattern": "^https://image5\\.sahibinden\\.com/staticContent/[0-9A-Fa-f]{8}/[0-9A-Fa-f]{4}/[0-9A-Fa-f]{4}/[0-9A-Fa-f]{4}/[0-9A-Fa-f]{12}/[0-9]{10}\\.pdf$"
  },
  "requestId": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{8,64}$",
   "maxLength": 64,
   "minLength": 8
  },
  "properties": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "propertyId",
     "city",
     "priceTry",
     "areaM2"
    ],
    "properties": {
     "city": {
      "enum": [
       "Türkiye",
       "İstanbul",
       "Ankara",
       "İzmir"
      ],
      "type": "string"
     },
     "areaM2": {
      "type": "number",
      "maximum": 5000,
      "minimum": 10
     },
     "priceTry": {
      "type": "number",
      "maximum": 100000000000,
      "minimum": 10000
     },
     "propertyId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "maxLength": 64,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 50,
   "minItems": 1
  },
  "slowMarketDays": {
   "type": "number",
   "maximum": 365,
   "minimum": 1
  },
  "maxTotalChargeUsd": {
   "type": "number",
   "maximum": 100,
   "minimum": 0.005
  },
  "maxReportAgeMonths": {
   "type": "integer",
   "maximum": 36,
   "minimum": 1
  },
  "deviationThresholdPct": {
   "type": "number",
   "maximum": 100,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "city": "İstanbul",
    "action": "below_aggregate_market_review",
    "source": {
     "url": "https://image5.sahibinden.com/staticContent/46800756/5ff7/403d/a818/c375e3143738/1774419975.pdf",
     "bytes": 947152,
     "sha256": "db415bd53eb7b1eb725ad1053ae3b324b685f123be149809d565b46d1c9bd607",
     "pageCount": 9,
     "contentType": "application/pdf",
     "retrievedAt": "2026-08-14T06:31:32.594Z",
     "canonicalSha256": "2efac92ba189663600c48f914ab67d2e218367ac23ddcc9bf0852276cdd8d285",
     "verificationMode": "pdf_container_text_public_report_semantics"
    },
    "country": "TR",
    "product": "sahibindex-property-market-benchmark",
    "reasons": {
     "freshness": "6 months from reference period",
     "liquidity": "65.3 closed-listing days vs 75-day slow-market threshold",
     "threshold": "10% absolute deviation threshold",
     "comparison": "55000 TRY/m² vs 61842 TRY/m² aggregate asking-price benchmark"
    },
    "baseline": false,
    "billable": true,
    "decision": "aggregate property benchmark",
    "stableId": "SAHIBINDEX:SALE:2026-02:1774419975:istanbul_demo_001_b8577a34:94c34f8f38d93a7e",
    "confidence": "low",
    "propertyId": "istanbul_demo_001_b8577a34",
    "reportType": "sale",
    "attribution": "Source: sahibinden.com and BETAM, sahibindex Satılık Konut Piyasası Görünümü; public aggregate report only.",
    "reportMonth": "2026-03",
    "sourceStats": {
     "reportMonth": "2026-03",
     "sourceFileId": "1774419975",
     "referenceMonth": "2026-02",
     "reportStableId": "SAHIBINDEX:SALE:2026-02:1774419975",
     "supportedCities": [
      "Türkiye",
      "İstanbul",
      "Ankara",
      "İzmir"
     ],
     "candidateSignalCount": 3
    },
    "deviationPct": -11.06,
    "sourceFileId": "1774419975",
    "schemaVersion": "1.0",
    "subjectAreaM2": 100,
    "criteriaSha256": "59f385a454c0c35f6d1a38f2b1a5048b96154f836b37d68f52a09f00b6be91ff",
    "propertyDigest": "94c34f8f38d93a7eef420a0618292f5f4fce655829792d4331be6280a3569506",
    "referenceMonth": "2026-02",
    "reportStableId": "SAHIBINDEX:SALE:2026-02:1774419975",
    "slowMarketDays": 75,
    "liquiditySignal": "normal",
    "reportAgeMonths": 6,
    "subjectPriceTry": 5500000,
    "methodologyCaveat": "Aggregate asking-price benchmark, not a listing scrape, transaction valuation, appraisal, investment recommendation, or proo
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sahibindex-property-market-benchmark-33f78f20/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)
