# netintel.dev Schema Mapper

> netintel.dev Schema Mapper is a paid API for AI agents from netintel.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-13).

Transforms a source object into a target schema by matching fields via aliases, structure, and optional LLM-based semantic mapping, with per-field confidence scores and a detailed mapping report.

## Facts

- Endpoint: POST https://netintel.dev/schema/map?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netintel-dev-schema-mapper-ff57146f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ksAQhcd2tLhXCqvwFwaZH

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 netintel-dev-schema-mapper-ff57146f -d '<json body>'
```

Example prompt: Map this user profile object — which has fields like 'name', 'contact', and 'dob' — to a target schema that expects 'full_name' (string), 'email' (string), and 'birth_date' (string in ISO format); apply a toISO transform to the date field and use 'USD' as a default for any 'currency' field that's missing.

## When to prefer this

Choose this endpoint when you need to reshape a JSON object between two schemas with different field names, structures, or types — especially when field names are semantically similar but not identical (e.g. 'name' vs 'full_name'), or when you need deterministic alias matching plus optional LLM fallback for ambiguous fields. It's ideal for integration pipelines, ETL workflows, and API bridging where you need a structured report of what mapped and what didn't, with per-field confidence. Prefer this over generic LLM prompting when you want deterministic alias resolution first and LLM only as a fallback, and when you need explicit transforms (toNumber, toISO, etc.) and defaults applied automatically.

## Known failure modes

- Source object exceeds 64KB or 200 fields — rejected
- Target schema is malformed or unparseable — error returned
- allow_llm=false and fields can't be deterministically matched — fields land in missing_target
- Hints reference non-existent source fields — mapping falls back to automatic
- Invalid transform name specified — per-field error in report
- Ambiguous semantic mapping with low confidence — reflected in per-field confidence scores

## How this service works

Transform a source object into a target schema — matches fields by alias and structure deterministically, uses an LLM only for semantic mapping when needed, and supports mapping hints, transforms, and defaults, so agents can reshape data between systems with per-field confidence and a clear report of what mapped and what didn't.

## Output

Returns a mapped object conforming to the target schema, with per-field confidence scores, a letter grade for overall mapping quality, and lists of successfully mapped fields, missing target fields, and unmapped source fields. In permissive mode, unmatched required fields are null with warnings; in strict mode they are omitted.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "source",
      "target_schema"
     ],
     "properties": {
      "mode": {
       "type": "string",
       "description": "\"permissive\" (default): an unmapped target field is null + a warning. \"strict\": it is omitted from `mapped`. Either way an incomplete mapping is a 200 with missing_target listed, never an error."
      },
      "hints": {
       "type": "object",
       "description": "Optional explicit mapping, keyed by target field: {\"full_name\":\"name\"} or {\"full_name\":[\"name\",\"contact\"]}. Hints outrank every automatic match."
      },
      "source": {
       "type": "object",
       "description": "The object to transform. Nested objects are addressed by dot path. Max 64KB / 200 fields."
      },
      "defaults": {
       "type": "object",
       "description": "Optional value per target field to use when the source has no match: {\"currency\":\"USD\"}."
      },
      "allow_llm": {
       "type": "boolean",
       "description": "Default true. Gates semantic mapping. When false, fields the rules cannot match land in missing_target and no model is called."
      },
      "transforms": {
       "type": "object",
       "description": "Optional per-target-field transform: {\"price\":\"toNumber\"}. One of: toNumber, toInteger, toString, toBoolean, toISO, toDate, trim, toLowerCase, toUpperCase, toArray."
      },
      "target_schema": {
       "type": "object",
       "description": "Desired output shape. JSON Schema ({\"type\":\"object\",\"properties\":{...},\"required\":[...]}) or a field→type map ({\"full_name\":\"string\",\"price\":\"number\",\"bio\":\"string?\"}). In the map form a field is required unless suffixed with '?'."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "grade": "A",
  "score": 100,
  "mapped": {
   "price": 19.99,
   "full_name": "Jane Doe"
  },
  "findings": [],
  "warnings": [],
  "schema_valid": true,
  "mapped_fields": [
   {
    "method": "alias",
    "source": "name",
    "target": "full_name",
    "confidence": 1
   },
   {
    "method": "alias",
    "source": "cost",
    "target": "price",
    "confidence": 1
   }
  ],
  "missing_target": [],
  "unmapped_source": [
   "internal_id"
  ],
  "type_conversions": [
   {
    "to": "number",
    "from": "string",
    "field": "price"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netintel-dev-schema-mapper-ff57146f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from netintel.dev](https://www.zero.xyz/host/netintel.dev/llms.txt)