# Dappier Real-Time Search (dm_01jhtt138wf1b9j8jwswye99y5)

> Dappier Real-Time Search (dm_01jhtt138wf1b9j8jwswye99y5) is a free API for AI agents from agents.dappier.com, Free, status healthy (last checked 2026-09-15, last successful call 2026-08-20).

Searches a specific Dappier data model for real-time articles, news, and web content using natural language queries with configurable ranking strategies.

## Facts

- Endpoint: POST https://agents.dappier.com/zeroclick/v2/search?data_model_id=dm_01jhtt138wf1b9j8jwswye99y5
- Price: Free
- Status: healthy
- Last checked: 2026-09-15
- Last successful call: 2026-08-20
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dappier-real-time-search-dm-01jhtt138wf1b9j8jwswye99y5-b7857827
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E3usEPjV7DqA1LIBs3CHA

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 dappier-real-time-search-dm-01jhtt138wf1b9j8jwswye99y5-b7857827 -d '<json body>'
```

Example prompt: Search Dappier for the 5 most recent articles about the Federal Reserve interest rate decision, ranked by most recent, and give me a summary of what each one says.

## When to prefer this

Choose this endpoint when you need real-time article and news search against a specific Dappier data model (dm_01jhtt138wf1b9j8jwswye99y5), especially when you want flexible ranking strategies (recency, semantic, trending) and optional domain filtering. Prefer it over generic web search APIs when you need structured article metadata (author, pubdate, image) alongside content previews, or when you want to prioritize results from a specific publisher domain.

## Known failure modes

- Missing required 'query' field returns a validation error
- Invalid data_model_id results in no results or authorization error
- Unsupported search_algorithm enum value causes a 400 error
- Requesting too many results or an out-of-range page returns empty results
- Network timeout if Dappier upstream is slow or unavailable

## How this service works

Access real-time search with Dappier’s AI models — from live web search and breaking news to stock prices and financial insights. Fast, reliable, and ready for monetization. This server is a pay-per-use, transparent proxy in front of Dappier's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. This document is the source of truth for agents: it lists the complete verified paid surface with each operation's live price in its x-payment-info. Endpoints not listed here are not part of the supported catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge.

This capability is scoped to data_model_id=dm_01jhtt138wf1b9j8jwswye99y5.

## Output

Returns an array of article objects, each containing the article URL, title, author name, publication date, site name, site domain, image URL, and a preview snippet of the content — all matching the natural language query and ranked by the chosen algorithm.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "ref": {
   "type": "string",
   "description": "Optional site domain to prioritize articles from, for example techcrunch.com."
  },
  "page": {
   "type": "integer",
   "description": "Results page."
  },
  "query": {
   "type": "string",
   "description": "A natural language query for articles from the selected data model."
  },
  "num_results": {
   "type": "integer",
   "description": "Number of articles to return."
  },
  "num_articles_ref": {
   "type": "integer",
   "description": "Minimum number of articles from the ref domain when ref is set."
  },
  "search_algorithm": {
   "enum": [
    "most_recent",
    "semantic",
    "most_recent_semantic",
    "trending"
   ],
   "type": "string",
   "description": "Ranking strategy for results."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "results"
 ],
 "properties": {
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "url": {
      "type": "string"
     },
     "site": {
      "type": "string"
     },
     "title": {
      "type": "string"
     },
     "author": {
      "type": "string"
     },
     "pubdate": {
      "type": "string"
     },
     "image_url": {
      "type": "string"
     },
     "site_domain": {
      "type": "string"
     },
     "preview_content": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dappier-real-time-search-dm-01jhtt138wf1b9j8jwswye99y5-b7857827/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.dappier.com](https://www.zero.xyz/host/agents.dappier.com/llms.txt)