Developer Hub

Build on Verified Trust

Integrate blockchain-verified business data, PoP reputation scores, and AI-powered fraud detection into your applications with our REST API.

Get API Key Quick Start

bash

curl -X GET "https://mybusinesstree.com/api/businesses/biz_abc123" \
  -H "Authorization: Bearer mbt_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

Get Started in Minutes

Three steps to integrate verified business data into your application.

Step 1

Get Your API Key

typescript

// Your API key is available in your dashboard
// Settings > Developer > API Keys
const API_KEY = "mbt_live_xxxxxxxxxxxxxxxx";

Step 2

Make Your First Request

Use the REST API to fetch verified business data. All responses include PoP scores and verification status.

typescript

const response = await fetch(
  "https://mybusinesstree.com/api/businesses?search=coffee&city=austin",
  {
    headers: {
      "Authorization": "Bearer mbt_live_xxxxxxxxxxxxxxxx",
      "Content-Type": "application/json",
    },
  }
);

const data = await response.json();
console.log(data.businesses);

Step 3

Handle Responses

Parse the structured JSON response. Each business includes verification details, PoP score, and review summaries.

typescript

// Response shape
{
  "businesses": [
    {
      "id": "biz_abc123",
      "name": "Austin Coffee Co.",
      "popScore": 87,
      "verificationLevel": "VERIFIED",
      "empireChainHash": "0x3f2a...",
      "reviewSummary": {
        "average": 4.6,
        "total": 142,
        "shieldStatus": "CLEAN"
      }
    }
  ],
  "pagination": { "page": 1, "total": 24 }
}

SDKs & Libraries

Start with our REST API today. Official SDKs are on the way.

REST API

Available

Full-featured RESTful API with JSON responses. Works with any language or framework.

Node.js SDK

Coming Soon

Type-safe client with built-in retry logic, pagination helpers, and webhook verification.

Python SDK

Coming Soon

Async-first Python client with Pydantic models and comprehensive type hints.

See It in Action

Fetch verified reviews with PoP scores and Shield status in a single request.

typescript

// Fetch verified reviews for a business
async function getVerifiedReviews(businessId: string) {
  const response = await fetch(
    `https://mybusinesstree.com/api/reviews?businessId=${businessId}&verified=true`,
    {
      headers: {
        "Authorization": `Bearer ${process.env.MBT_API_KEY}`,
        "Content-Type": "application/json",
      },
    }
  );

  if (!response.ok) {
    throw new Error(`API error: ${response.status}`);
  }

  const { reviews, meta } = await response.json();

  // Each review includes verification details
  reviews.forEach((review) => {
    console.log(`${review.author} (PoP: ${review.authorPopScore})`);
    console.log(`  Rating: ${review.rating}/5`);
    console.log(`  Shield: ${review.shieldStatus}`);  // CLEAN | FLAGGED | UNDER_REVIEW
    console.log(`  Chain:  ${review.empireChainHash}`);
  });

  return { reviews, meta };
}

Key Concepts

Understand the building blocks that make MyBusinessTree's trust layer unique.

PoP Scores

Proof of Personhood

A reputation metric (0-100) calculated from verified interactions, review quality, response patterns, and blockchain-anchored trust signals. PoP scores are resistant to manipulation because they require real human verification.

Empire Chain

Immutable Trust Ledger

Our custom blockchain records every review, verification event, and trust score change. Each block is SHA-256 hashed and linked, creating a tamper-proof audit trail that developers can verify independently.

The Shield

AI Fraud Detection

An AI-powered system that analyzes review patterns, detects anomalies, and flags suspicious activity in real-time. The Shield protects the integrity of all data flowing through the platform.

Verification Types

Multi-Layer Trust

Businesses and reviewers are verified through multiple channels: email, phone, government ID, business license, and on-site QR check-ins. Each layer increases trust and unlocks higher PoP score potential.

Webhooks

Receive real-time notifications for payment events, review verifications, and business status changes. Webhooks are delivered via HTTPS POST with a signed payload you can verify using your webhook secret.

payment.succeeded

A subscription payment was successfully processed

payment.failed

A payment attempt failed or was declined

subscription.created

A new subscription was activated

subscription.canceled

A subscription was canceled by the user

review.verified

A review passed Shield verification

business.verified

A business completed identity verification

typescript

// Verify and handle webhook events
import { headers } from "next/headers";
import Stripe from "stripe";

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

export async function POST(req: Request) {
  const body = await req.text();
  const headersList = await headers();
  const signature = headersList.get("stripe-signature")!;

  let event: Stripe.Event;

  try {
    event = stripe.webhooks.constructEvent(
      body,
      signature,
      process.env.STRIPE_WEBHOOK_SECRET!
    );
  } catch (err) {
    return new Response("Invalid signature", { status: 400 });
  }

  switch (event.type) {
    case "checkout.session.completed":
      // Activate subscription, update PoP score
      await activateSubscription(event.data.object);
      break;
    case "invoice.payment_failed":
      // Handle failed payment
      await handleFailedPayment(event.data.object);
      break;
  }

  return new Response("OK", { status: 200 });
}