Skip to main content
POST
Get AI Article Recommendations (ZeroClick-authenticated)

Authorizations

zc-signature
string
header
required

HMAC signature minted by ZeroClick over the raw request bytes, of the form t=<unix-seconds>,kid=<key-id>,v1=<hex-hmac>. The canonical string signed is t \n METHOD \n path+query \n sha256hex(body) \n zc-request-id \n zc-agent-id, and v1 = hex(HMAC_SHA256(secret, canonical)). Verified against the seller's signing secret keyed by kid, with a ±300s timestamp skew bound.

A missing or invalid signature is rejected with 401 invalid_zeroclick_signature; this is never failed open.

Headers

zc-request-id
string
required

ZeroClick request id, set by ZeroClick when it proxies the request. It is part of the signed canonical string, so a request without it cannot verify.

Example:

"zcreq_1"

zc-agent-id
string

Identifier of the buying agent. Used to partition logs/analytics by agent; becomes the synthesized caller identity (zeroclick:<agent-id>). Treated as an empty string when absent, which the signer must match.

Example:

"agt_1"

Query Parameters

data_model_id
enum<string>
required

Data model to search. Must be one of the live data models below.

  • dm_01jhtt138wf1b9j8jwswye99y5 — 9 and 10 News: local news, weather, sports and community stories for Northern Michigan (Cadillac, Traverse City).
  • dm_01jmxn1a9tem8bq1nzbzjck8c4 — Benzinga: real-time financial news, earnings reports and market trends from Benzinga.com.
  • dm_01jketafckeh0vxacqv1s295j0 — CafeMom Parenting: parenting advice, family tips, self-care and life hacks from Mom.com, CafeMom, LittleThings and MamasLatinas.
  • dm_01jh3jg18fe92v4az2h2163t8k — MethodShop: tech guides, how-tos and digital lifestyle articles on gadgets, media and productivity from MethodShop.com.
  • dm_01jagy9nqaeer9hxx8z1sk1jx6 — WISH-TV AI: Indiana news, weather, sports scores, traffic and local events from WISH-TV.
  • dm_01j1sza0h7ekhaecys2p3y0vmj — iHeartCats AI: cat health, behavior, lifestyle, grooming and ownership articles from iheartcats.com.
  • dm_01j1sz8t3qe6v9g8ad102kvmqn — iHeartDogs AI: dog health, behavior, lifestyle, grooming and ownership articles from iheartdogs.com.

The live catalog is also available without a login at https://api.dappier.com/app/mcp/tools; use each entry's data_model_external_id. The real-time-search entry is served by POST /zeroclick/aimodel/{aimodel_external_id}, not by this endpoint.

Available options:
dm_01jhtt138wf1b9j8jwswye99y5,
dm_01jmxn1a9tem8bq1nzbzjck8c4,
dm_01jketafckeh0vxacqv1s295j0,
dm_01jh3jg18fe92v4az2h2163t8k,
dm_01jagy9nqaeer9hxx8z1sk1jx6,
dm_01j1sza0h7ekhaecys2p3y0vmj,
dm_01j1sz8t3qe6v9g8ad102kvmqn
Example:

"dm_01jmxn1a9tem8bq1nzbzjck8c4"

search_version
string

Optional search version override, forwarded to the retrieval pipeline.

Body

application/json
query
string
required

Natural language query, keyword, or URL. If a URL is specified, our AI analyzes the page context, summarizes it, and provides semantic recommendations based on the content.

similarity_top_k
integer
default:9

The number of articles to return.

ref
string

The site domain where AI recommendations are being displayed. Example format: dappier.com.

num_articles_ref
integer
default:0

The minimum number of articles from the ref domain specified above. The rest of the articles will come from other sites within the RAG model.

search_type
string

Optional search type forwarded to the retrieval pipeline.

search_algorithm
enum<string>

The search algorithm for retrieving articles. most_recent: Retrieves the most recent articles by publication date. semantic (default): Retrieves contextually relevant articles based on the query or the page content from the provided URL. most_recent_semantic: Performs semantic search and retrieves the most recent articles by publication date. trending: Performs a trending search and retrieves the most relevant articles to trending keywords in the past 24 hours.

Available options:
most_recent,
semantic,
most_recent_semantic,
trending
page
integer
default:1

Page number for pagination.

num_results
integer
default:10

Number of results per page.

Response

Article recommendations. Includes the zc-usage header settling usage with ZeroClick.

status
string

The status of the API response.

response
object