Get AI Article Recommendations (ZeroClick-authenticated)

curl --request POST \
  --url https://api.dappier.com/zeroclick/v2/search \
  --header 'Content-Type: application/json' \
  --header 'zc-request-id: <zc-request-id>' \
  --header 'zc-signature: <api-key>' \
  --data '
{
  "query": "latest developments in electric vehicles",
  "similarity_top_k": 9,
  "search_algorithm": "semantic"
}
'

import requests

url = "https://api.dappier.com/zeroclick/v2/search"

payload = {
    "query": "latest developments in electric vehicles",
    "similarity_top_k": 9,
    "search_algorithm": "semantic"
}
headers = {
    "zc-request-id": "<zc-request-id>",
    "zc-signature": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'zc-request-id': '<zc-request-id>',
    'zc-signature': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'latest developments in electric vehicles',
    similarity_top_k: 9,
    search_algorithm: 'semantic'
  })
};

fetch('https://api.dappier.com/zeroclick/v2/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dappier.com/zeroclick/v2/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'latest developments in electric vehicles',
    'similarity_top_k' => 9,
    'search_algorithm' => 'semantic'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "zc-request-id: <zc-request-id>",
    "zc-signature: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dappier.com/zeroclick/v2/search"

	payload := strings.NewReader("{\n  \"query\": \"latest developments in electric vehicles\",\n  \"similarity_top_k\": 9,\n  \"search_algorithm\": \"semantic\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("zc-request-id", "<zc-request-id>")
	req.Header.Add("zc-signature", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dappier.com/zeroclick/v2/search")
  .header("zc-request-id", "<zc-request-id>")
  .header("zc-signature", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"latest developments in electric vehicles\",\n  \"similarity_top_k\": 9,\n  \"search_algorithm\": \"semantic\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dappier.com/zeroclick/v2/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["zc-request-id"] = '<zc-request-id>'
request["zc-signature"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"latest developments in electric vehicles\",\n  \"similarity_top_k\": 9,\n  \"search_algorithm\": \"semantic\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "response": {
    "query": "<string>",
    "results": [
      {
        "author": "<string>",
        "image_url": "<string>",
        "preview_content": "<string>",
        "pubdate": "<string>",
        "pubdate_unix": 123,
        "score": 123,
        "site": "<string>",
        "site_domain": "<string>",
        "source_url": "<string>",
        "summary": "<string>",
        "title": "<string>",
        "url": "<string>"
      }
    ],
    "message": "<string>"
  }
}

ZeroClick APIs

AI Recommendations (ZeroClick)

Semantic article search against a Dappier data model, authenticated by verifying the zc-signature HMAC over the raw request bytes. The same orchestration as POST /app/v2/search runs behind it.

Only marketplace-enabled data models are reachable — ZeroClick traffic carries no Dappier tenant, so a private data model resolves to 404.

On success, usage is settled with ZeroClick and reported via the zc-usage response header. The request is not charged on the Dappier platform.

POST

zeroclick

Get AI Article Recommendations (ZeroClick-authenticated)

curl --request POST \
  --url https://api.dappier.com/zeroclick/v2/search \
  --header 'Content-Type: application/json' \
  --header 'zc-request-id: <zc-request-id>' \
  --header 'zc-signature: <api-key>' \
  --data '
{
  "query": "latest developments in electric vehicles",
  "similarity_top_k": 9,
  "search_algorithm": "semantic"
}
'

import requests

url = "https://api.dappier.com/zeroclick/v2/search"

payload = {
    "query": "latest developments in electric vehicles",
    "similarity_top_k": 9,
    "search_algorithm": "semantic"
}
headers = {
    "zc-request-id": "<zc-request-id>",
    "zc-signature": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'zc-request-id': '<zc-request-id>',
    'zc-signature': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'latest developments in electric vehicles',
    similarity_top_k: 9,
    search_algorithm: 'semantic'
  })
};

fetch('https://api.dappier.com/zeroclick/v2/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dappier.com/zeroclick/v2/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'latest developments in electric vehicles',
    'similarity_top_k' => 9,
    'search_algorithm' => 'semantic'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "zc-request-id: <zc-request-id>",
    "zc-signature: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dappier.com/zeroclick/v2/search"

	payload := strings.NewReader("{\n  \"query\": \"latest developments in electric vehicles\",\n  \"similarity_top_k\": 9,\n  \"search_algorithm\": \"semantic\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("zc-request-id", "<zc-request-id>")
	req.Header.Add("zc-signature", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dappier.com/zeroclick/v2/search")
  .header("zc-request-id", "<zc-request-id>")
  .header("zc-signature", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"latest developments in electric vehicles\",\n  \"similarity_top_k\": 9,\n  \"search_algorithm\": \"semantic\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dappier.com/zeroclick/v2/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["zc-request-id"] = '<zc-request-id>'
request["zc-signature"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"latest developments in electric vehicles\",\n  \"similarity_top_k\": 9,\n  \"search_algorithm\": \"semantic\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "<string>",
  "response": {
    "query": "<string>",
    "results": [
      {
        "author": "<string>",
        "image_url": "<string>",
        "preview_content": "<string>",
        "pubdate": "<string>",
        "pubdate_unix": 123,
        "score": 123,
        "site": "<string>",
        "site_domain": "<string>",
        "source_url": "<string>",
        "summary": "<string>",
        "title": "<string>",
        "url": "<string>"
      }
    ],
    "message": "<string>"
  }
}

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

string

required

Data model ID, starting with dm_. Browse and find data models in the Dappier Marketplace.

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

Show child attributes

Developer APIs

Publisher APIs

ZeroClick APIs

Analytics APIs

AI Recommendations (ZeroClick)

Authorizations

Headers

Query Parameters

Body

Response