API Documentation

Quick Start

Get started with Angosa API in under 10 minutes. Embed products on any website with just 3 lines of code.

1. Get Your API Key

2. Embed a Product

Add this code to any HTML page:

<!-- Load Angosa SDK -->
<script src="https://cdn.Angosa.com/sdk.js"></script>

<!-- Embed Product -->
<div data-Angosa-product="YOUR_PRODUCT_ID"></div>

<script>
  Angosa.init({
    apiKey: 'YOUR_API_KEY'
  });
</script>

3. Start Selling

That's it! Your product is now purchaseable with one-click checkout.

REST API Reference

All API requests should be made to: https://api.Angosa.com/v1

Authentication

Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Create Product

POST /products

Request Body:

{
  "name": "Premium Wireless Headphones",
  "description": "High-quality audio experience",
  "price": 99.00,
  "currency": "USD",
  "images": ["https://example.com/image.jpg"],
  "stock": 100
}

Response:

{
  "id": "prod_abc123",
  "name": "Premium Wireless Headphones",
  "url": "https://Angosa.com/p/abc123",
  "embed_code": "<div data-Angosa-product='abc123'></div>",
  "created_at": "2025-01-15T10:30:00Z"
}

Get Product

GET /products/{id}

Response:

{
  "id": "prod_abc123",
  "name": "Premium Wireless Headphones",
  "price": 99.00,
  "stock": 95,
  "sales_count": 5,
  "conversion_rate": 0.42
}

List Orders

GET /orders

Response:

{
  "data": [
    {
      "id": "order_xyz789",
      "product_id": "prod_abc123",
      "amount": 99.00,
      "customer_email": "customer@example.com",
      "status": "completed",
      "created_at": "2025-01-15T14:22:00Z"
    }
  ],
  "total": 1,
  "page": 1
}

Webhooks

Receive real-time notifications when events occur.

Available Events

order.created - New order placed
order.completed - Order fulfilled
product.low_stock - Stock below threshold
product.sold_out - Product out of stock

Webhook Payload Example

{
  "event": "order.created",
  "data": {
    "id": "order_xyz789",
    "product_id": "prod_abc123",
    "amount": 99.00,
    "customer_email": "customer@example.com"
  },
  "timestamp": "2025-01-15T14:22:00Z"
}

Official SDKs

JavaScript

npm install @Angosa/sdk

Python

pip install Angosa

PHP

composer require Angosa/sdk

Rate Limits

Standard tier: 1,000 requests per hour
Headers: Check X-RateLimit-Remaining for remaining requests
Exceeded limits: Returns 429 Too Many Requests
Need more? Contact us for higher limits

Ready to Start Building?

Get your API key and start integrating in minutes.

Get API Key →