Get search report

GET /publisher/search-report

Returns daily Search metrics grouped by country and feed for the authenticated publisher.

Query parameters

Parameter	Required	Description
token	Yes	Publisher API key with publisher:search:read.
date_from	Yes	Inclusive start date in YYYY-MM-DD.
date_to	Yes	Inclusive end date in YYYY-MM-DD.
sid	No	Positive Search link/feed identifier.
export	No	json or csv.

cURL

curl --get "https://api.example.com/publisher/search-report" \
  --data-urlencode "token=YOUR_NEXUS_API_KEY" \
  --data-urlencode "date_from=2026-08-01" \
  --data-urlencode "date_to=2026-08-17" \
  --data-urlencode "sid=422"

JavaScript

const params = new URLSearchParams({
  token: process.env.NEXUS_API_KEY,
  date_from: "2026-08-01",
  date_to: "2026-08-17",
  sid: "422"
});

const response = await fetch(
  `https://api.example.com/publisher/search-report?${params}`
);

if (!response.ok) throw new Error(`Nexus returned ${response.status}`);
console.log(await response.json());

Python

import os
import requests

response = requests.get(
    "https://api.example.com/publisher/search-report",
    params={
        "token": os.environ["NEXUS_API_KEY"],
        "date_from": "2026-08-01",
        "date_to": "2026-08-17",
        "sid": 422,
    },
    timeout=15,
)
response.raise_for_status()
print(response.json())

Example response

{
  "status": "success",
  "message": "Publisher Search Links report",
  "data": [
    {
      "date": "2026-08-17",
      "feed": 422,
      "geo": "US",
      "subid": "",
      "total": "9007",
      "monetized": "8460",
      "clicks": "4235",
      "revenue": "165.5900000000",
      "epc": "0.039100",
      "rpm": "18.384590"
    }
  ]
}

For CSV, set export=csv and save the response body as a file.