# Mekler AI Feed Record Mapping Inspector

> Mekler AI Feed Record Mapping Inspector is a paid API for AI agents from api.mekler.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Fetches a public RSS, Atom, or JSON feed URL and returns a normalized record mapping, field coverage stats, duplicate evidence, and ID provenance for up to 100 records.

## Facts

- Endpoint: POST https://api.mekler.ai/v1/data/feeds/inspect-record-mapping?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mekler-ai-feed-record-mapping-inspector-208d0ff9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_37Mvj3sPi-OuJ8rcvsaxl

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 mekler-ai-feed-record-mapping-inspector-208d0ff9 -d '<json body>'
```

Example prompt: Inspect the NASA news feed at https://www.nasa.gov/feed/ and return up to 30 records — show me the field mapping, how many records have source IDs, and whether there are any duplicate IDs.

## When to prefer this

Choose this endpoint when you need to inspect, normalize, or audit the structure of a public RSS, Atom, or JSON feed before ingesting it — especially to understand field mappings, verify ID consistency, detect duplicates, and measure field coverage. Prefer it over generic HTTP fetching when you want structured feed metadata rather than raw XML/JSON, and when feeds are under 256 KiB and publicly accessible without authentication or JavaScript.

## Known failure modes

- Feed URL is unreachable or returns non-2xx HTTP — status field indicates error
- Feed exceeds 256 KiB uncompressed — document is rejected or truncated
- Feed format not recognized as RSS 2.0, Atom 1.0, or JSON feed — parsing fails
- records_path JSON Pointer does not point to a valid array in a JSON feed — mapping fails
- Feed requires authentication or JavaScript rendering — not supported, returns error
- max_records out of range (below 1 or above 100) — request rejected with validation error
- request_id does not match required pattern — request rejected

## How this service works

Inspect a public RSS, Atom or JSON feed and return a verified record mapping, normalized preview, ID provenance, duplicate evidence and field coverage. One uncompressed UTF-8 document up to 256 KiB; maximum 100 returned records. No pagination, complete history, JavaScript rendering or safe-link guarantee.

## Output

A JSON object containing the detected feed format, a field mapping showing which source fields correspond to standard fields (id, url, title, published), up to 100 normalized record previews each with ID basis, field coverage counts (total source records, returned records, source_id_records, duplicate_ids_in_returned), whether results were truncated, the records_path used, observed_at timestamp, source_url, and a limitations array explaining what the endpoint does not guarantee.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 2048
  },
  "request_id": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{16,64}$"
  },
  "max_records": {
   "type": "integer",
   "default": 20,
   "maximum": 100,
   "minimum": 1
  },
  "records_path": {
   "type": [
    "string",
    "null"
   ],
   "maxLength": 128
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "format": "rss",
  "status": "ok",
  "mapping": {
   "id": "guid",
   "url": "link",
   "title": "title",
   "published": "pubDate"
  },
  "records": [
   {
    "id": "mekler-example-1",
    "url": "https://mekler.ai/",
    "title": "Mekler feed example",
    "id_basis": "source_id",
    "published": "Tue, 20 Oct 2026 00:00:00 GMT"
   }
  ],
  "coverage": {
   "truncated": false,
   "field_counts": {
    "id": 1,
    "url": 1,
    "title": 1,
    "published": 1
   },
   "source_records": 1,
   "returned_records": 1,
   "source_id_records": 1,
   "duplicate_ids_in_returned": 0
  },
  "source_url": "https://www.nasa.gov/feed/",
  "limitations": [
   "One uncompressed UTF-8 RSS 2.0, Atom 1.0 or JSON document up to 256 KiB; previews also stop at 40000 serialized UTF-8 bytes. No JavaScript, authentication, pagination or complete-history claim.",
   "JSON mapping chooses the first recognized field in documented precedence; inspect mapping and field_counts. Optional records_path is a JSON Pointer to the record array.",
   "Source IDs are retained; URL hashes are stable while URLs persist; content hashes change when content changes. Duplicates remain visible.",
   "Dates are source strings, not verified event times. Links are normalized but not fetched or proven safe. Descriptions, markup and enclosures are not included."
  ],
  "observed_at": "2026-10-20T00:00:00Z",
  "records_path": "/rss/channel/item"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mekler-ai-feed-record-mapping-inspector-208d0ff9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mekler.ai](https://www.zero.xyz/host/api.mekler.ai/llms.txt)