# Macaroon Network Scientific Dataset Search

> Macaroon Network Scientific Dataset Search is a paid API for AI agents from api.macaroonnetwork.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Search an indexed corpus of scientific datasets by topic and retrieve structured metadata pointers, licence declarations, provenance, and freshness information without downloading the actual data files.

## Facts

- Endpoint: POST https://api.macaroonnetwork.com/execute/polymathica-scientific-dataset-search-v1
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/macaroon-network-scientific-dataset-search-846c045b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bue33r9RL-O27cPdWAavL

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 macaroon-network-scientific-dataset-search-846c045b -d '<json body>'
```

Example prompt: Search for scientific datasets related to climate change and sea level rise — I need to see their source links, licences, and how recent they are, but I don't need to download the actual files.

## When to prefer this

Choose this endpoint when an agent needs to discover scientific datasets by topic without downloading or redistributing actual data files. It is ideal for research workflows requiring licence verification, provenance auditing, or freshness checks before committing to a dataset. Prefer it over generic web search when structured, source-linked metadata is needed, and over data repositories' own APIs when aggregating across multiple domains in a single call.

## Known failure modes

- No matching datasets found for the query topic — returns empty result set
- Overly broad query terms may return a large unfiltered list requiring further refinement
- Dataset metadata may be stale if the underlying source has changed since last index crawl
- Ambiguous topic queries may surface tangentially related datasets from adjacent fields
- Payment processing failure returns 402 before any search is executed

## How this service works

Find source-linked scientific datasets by topic. Returns structured metadata pointers, declared licence fields, provenance and freshness without redistributing dataset files.

## Output

Structured metadata records for matching scientific datasets, including source URLs linking back to the original host, declared licence fields (e.g. CC BY, public domain), provenance details indicating dataset origin, and freshness indicators showing when the data was last indexed or updated. Actual dataset files are not transferred or redistributed.

## 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"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "payload": {
   "query": "",
   "total": 0,
   "records": [],
   "provenance": {
    "content_hash": null,
    "metadata_only": null,
    "no_outbound_network_on_purchase": null
   }
  },
  "settled": true,
  "predicate_passed": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/macaroon-network-scientific-dataset-search-846c045b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.macaroonnetwork.com](https://www.zero.xyz/host/api.macaroonnetwork.com/llms.txt)