SDKs Overview
Choose the right way to send events to Pieowl. Script tag, JavaScript, React Native, bot tracking, and the HTTP API for every other language.
Pieowl has SDKs for the web, Node.js and React Native. For every other language, you send events with a plain HTTP request to the Track API.
Quick start
For most web projects, start with one of these:
- Script Tag: The fastest way to start, no build step
- Web SDK: For TypeScript and more control
- Next.js: The script tag via
next/script| Setup guide
Web and browser
Simple integration
- Script Tag: Add analytics with one
<script>tag- No build step
- Works on any website
- Tracks page views automatically
JavaScript and TypeScript
-
Web SDK (
@pieowl/web): Browser SDK with TypeScript types- Typed API
- Page views, outgoing links and
data-trackclicks, chosen in Settings → Site - Optional session replay
-
JavaScript (Node / Generic) (
@pieowl/sdk): Core SDK- Works in Node.js and other JavaScript runtimes
- No framework needed
- Full tracking API
Frontend frameworks
Next.js, Astro and Nuxt use the Script Tag, plus @pieowl/bots on the server for AI crawlers and the ad-blocker proxy:
-
React: Use the Web SDK | Setup guide
-
Vue: Use the Web SDK | Setup guide
-
Remix: Use the Script Tag or Web SDK | Setup guide
-
Svelte, Angular, Solid.js: Use the Script Tag or Web SDK
Server side
-
JavaScript (Node / Generic) (
@pieowl/sdk): Server-side events from any Node.js server. See Express | Setup guide -
AI crawlers and bots (
@pieowl/bots): Report the AI crawlers and search bots the script can't see- Next.js, Express, Hono, Cloudflare Workers and any server with a Fetch
Request - Never blocks or slows your pages
- Includes a proxy that serves the script from your own domain, past ad blockers
- Next.js, Express, Hono, Cloudflare Workers and any server with a Fetch
-
HTTP API for other languages: Pieowl doesn't ship native SDKs for these languages. Each page shows how to send events with the language's own HTTP tools:
Mobile
-
React Native (
@pieowl/react-native) | Setup guide- iOS and Android
- Built for Expo
- Optional offline queue
-
Swift: Send events from iOS and macOS apps with the HTTP API
-
Kotlin: Send events from Android apps with the HTTP API
Need help choosing?
- Static website or HTML? Use the Script Tag
- React app? Use the Web SDK or the Script Tag
- Next.js app? Use the Script Tag with
next/script - Node.js server? Use the JavaScript SDK, and
@pieowl/botsfor AI crawlers - Another backend language? Use the HTTP API
- Mobile app? Use React Native, or the HTTP API from Swift or Kotlin
Core features
Every SDK and the HTTP API support:
Event tracking
Track custom events with properties to see what users do.
User identification
Link events to your users and build user profiles.
Global properties
Set properties once and send them with every event (SDKs only).
Increment and decrement
Change numeric properties on user profiles.
Privacy
No cookies, and IP addresses are never stored.
API reference
To track events with plain HTTP requests, read the Track API.
Support
Email us at hello@pieowl.com.