Browse the Spotlight archive

Use this skill when the user wants more than the current Spotlight: a date range, the most recent N days, or several specific days. All calls are anonymous, read-only HTTPS GET requests. Public API responses wrap items in data.

Recent days, newest first

1. Request https://nowyourlink.com/api/v1/spotlights?limit=20. limit accepts 1 to 50.
2. Read nextCursor from the response. When it is a YYYY-MM-DD string, request https://nowyourlink.com/api/v1/spotlights?limit=20&cursor=YYYY-MM-DD for the strictly older days.
3. Stop when nextCursor is null or when the requested range is covered. Do not crawl the full archive by default.
4. Never combine cursor with offset; the API rejects that request with 400. Legacy offset (0 to 10000) with nextOffset still works for callers that need it.

Several known days

1. Request https://nowyourlink.com/api/v1/spotlights/batch?days=2026-09-01,2026-09-02 with at most 10 dates.
2. Results keep the input order. Each item carries status 200 with the record or 404 when the day is unavailable or removed.

MCP alternative

With the https://nowyourlink.com/mcp server configured, list_spotlights accepts limit, offset or cursor with the same rules, and get_spotlight accepts one day.