advolcano.io

Developer APIs

Build custom workflows, automate campaign management, and integrate AdVolcano into your existing tech stack with our comprehensive REST API.

Quick start

Authenticate with your API key and make your first request in minutes.

curl examplebash
curl -X GET \
  https://api.advolcano.io/v2/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Authentication

All API requests require a Bearer token. Generate keys from your account settings.

response
{
  "data": [
    {
      "id": "camp_8x7k2m",
      "name": "Q2 Brand Awareness",
      "status": "active",
      "budget": 124500.00,
      "spend": 89234.12,
      "impressions": 48200000
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 12
  }
}

API reference

Core endpoints for campaign and audience management.

GET/v2/campaigns
POST/v2/campaigns
GET/v2/campaigns/{id}
PUT/v2/campaigns/{id}
GET/v2/reports/performance
POST/v2/audiences
GET/v2/audiences/{id}/reach
POST/v2/creatives

SDKs & libraries

Node.js
npm install @advolcano/sdk
Python
pip install advolcano
Go
go get github.com/advolcano/sdk-go

Rate limits & SLAs

1,000 req/min
Standard tier
10,000 req/min
Enterprise tier
99.9%
API uptime SLA

Get API access

Request developer credentials and sandbox environment access.

Request API Key