Readconv API Documentation

Readconv is not just an analytics tool.
It’s a new way to think about ecommerce data.

Most platforms hoard your data.
We help you understand it — and keep it yours.

Built for developers. Loved by growth teams. Trusted by founders.
Query any ecommerce metric directly from your event stream — modular, composable, and production-ready.


🧠 Why Readconv?

You own the warehouse. Why rent your insights?
Readconv connects directly to BigQuery (or lets you self-host) — no black box, no lock-in, no inflated dashboards.

  • 🧩 Composable: Each endpoint is small, focused, and stackable.
  • 📦 Self-describing: Return clean data, ready for apps or automations.
  • 🛠️ Dev-first: Add insights to your CRM, frontend, or BI layer.
  • 🔐 No vendor lock-in: Keep your data. Always.

Whether you're debugging funnels, optimizing conversion, or exploring product performance — Readconv gives you the tooling and flexibility to move like a modern team.


🔌 Getting Started

Start by connecting your event data — either via a direct BigQuery sync or by sending events to our API.

Once connected, explore our endpoints across:

  • Core Metrics/metrics/revenue, /metrics/errors, etc.
  • Product Intelligence/products/top-selling, /products/{id}/insights
  • Attribution & Ads/attribution/multi-touch
  • Personalization/recommendations/for-user

Readconv doesn’t box you into pre-built dashboards.
It becomes your backend for ecommerce analytics.


🛣️ A Better Path to Ecommerce Intelligence

Most analytics tools are bloated.
They try to be everything, but leave you with noisy data and no clarity.

We’re building the opposite:
A lean, powerful API surface that acts like an operating system for your event stream.

Instead of clicking through dashboards, query what you need:

GET /metrics/conversion-rate
GET /products/most-abandoned
GET /recommendations/related-products

Every endpoint returns actionable, structured JSON — ready to power UIs, Slack bots, LLMs, or whatever’s next.


📚 Use Cases

  • ✨ Show personalized product insights in your storefront
  • 🧠 Train AI agents on clean attribution + sales data
  • 📊 Build founder-facing dashboards in your own UI
  • 🔁 Automate daily reports via cron + Slack
  • ⚠️ Debug cart errors with clean product mapping

Guides

Quickstart

Get started making your first API requests with Readconv.

Read more

Authentication

Learn how to authenticate your API requests using a Bearer token.

Read more

Errors

Read about the different types of errors returned by the API.

Read more

Revenue

Track revenue over any defined period.

Read more

Conversion Rate

Measure how effectively visitors convert into customers.

Read more

Page Views

View how often pages on your site or app are being viewed.

Read more

Top Selling Products

Discover your top-performing products by revenue and quantity.

Read more

Product Revenue

Analyze revenue generated by individual products.

Read more

Resources

Quickstart

How to get started with the Readconv API and make your first request.

Authentication

Authenticate API requests with a secure Bearer token.

Error Handling

Understand API error codes and how to handle them.

Revenue Metric

Retrieve revenue data using metric endpoints.

Was this page helpful?