List search links

GET/publisher/search-links

Required scope: publisher:search:read

Authenticate with Authorization: Bearer YOUR_NEXUS_API_KEY. The legacy token query parameter remains available; use one transport per request.

Authentication and error codes →

Returns Search links available to the authenticated publisher.

Query parameters

Parameter	Required	Description
token	Only without Bearer	Compatibility transport for a publisher API key with publisher:search:read. Prefer the Authorization header; never send both.

cURL

curl --get "https://api.example.com/publisher/search-links" \
  --header "Authorization: Bearer YOUR_NEXUS_API_KEY"

JavaScript

const response = await fetch('https://api.example.com/publisher/search-links', {
  headers: { Authorization: `Bearer ${process.env.NEXUS_API_KEY}` },
});
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-links',
    headers={'Authorization': f"Bearer {os.environ['NEXUS_API_KEY']}"},
    timeout=15,
)
response.raise_for_status()
print(response.json())

Example response

{
  "status": "success",
  "message": "Search Links list",
  "data": [
    {
      "sid": 422,
      "name": "Example Search link",
      "enable_cap": false,
      "search_cap": 0,
      "created_at": "2026-08-01 11:26:28",
      "status": 1
    }
  ]
}

Reuse the Search link ID

Use the returned sid as the optional filter in Get search report.

Errors

401 indicates a missing or rejected key; 403 indicates insufficient permissions; 429 indicates a rate limit. See authentication errors and provide X-Request-ID for support.