Skip to main content
NearNode is the infrastructure layer for the physical web. Static QR codes and NFC tags are “dumb” endpoints. Once printed or deployed, their destination is fixed, and their performance is invisible. NearNode decouples the physical trigger from the digital destination, giving you a programmable edge network for physical assets.

​
Why NearNode?

  • Decoupled Logic: Change the target of 10,000 deployed assets instantly via API or Dashboard — without reprinting a single sticker.
  • Edge Routing: Route users based on geolocation, device type, time of day, or custom logic. A/B testing for the physical world.
  • Privacy-First Analytics: Measure foot traffic with the same granularity as web traffic — server-side, cookieless, GDPR-compliant.
  • Hardware Agnostic: Works with standard QR codes, NTAG213/215/216 chips, and hybrid assets. No proprietary hardware lock-in.

​
Key Concepts

​
The Node

A Node is a single physical-to-digital bridge. Every node has a unique, permanent slug (e.g., nearnode.io/v/r5v5z7t2) that acts as a pointer. The slug never changes — only the logic behind it does.
Ops Tip: You can manage nodes visually in the Dashboard without touching the API. Every API operation has a Dashboard equivalent.

​
Smart Routing

Unlike a standard redirect, a NearNode redirect is dynamic. You can configure routing rules that determine the final destination at the moment of the scan — based on time windows, geography, device type, or traffic split weights. 
# Route office-hours traffic to the welcome page
curl -X POST https://nearnode.io/api/v1/nodes/r5v5z7t2/rules \
  -H "Authorization: Bearer sk_live_..." \
  -d '{
    "rule_type": "time_based",
    "conditions": {
      "timezone": "Europe/Zurich",
      "windows": [{ "days": [1,2,3,4,5], "start_time": "08:00", "end_time": "18:00" }]
    },
    "function_type": "redirect",
    "payload": { "url": "https://acme.com/welcome" }
  }'

​
The Fleet

For enterprise scale, Nodes are managed in Batches. A Batch allows for bulk generation (up to 500 nodes), shared templates with locked fields, and group-level analytics. Deploy 10,000 smart labels from a single API call.

​
Developer-First

Everything you see in our dashboard is built on our Public API. Whether you want to automate tag generation in your factory, sync scan data to your CRM, or build a custom NFC writing workflow — our API makes it possible. 
curl -X POST https://nearnode.io/api/v1/nodes \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Basel HQ Entrance",
    "function_type": "redirect",
    "payload": { "url": "https://acme.com/checkin" }
  }'
Print that URL as a QR code. Encode it into an NFC tag. The URL never changes — only the destination behind it.

​
Next Steps

Quickstart

Deploy your first node in 5 minutes. API key to live scan URL.

Architecture

Understand edge routing, orchestration layers, and latency targets.

Smart Routing

Configure time-based, geo, device, and A/B routing rules.

API Reference

Full endpoint documentation with interactive playground.