Guides
Getting Started
Quick start guide for the Oviond Integration API
Getting Started
The Oviond Integration API provides a unified interface for fetching analytics data from 60+ marketing and business platforms.
Base URL
https://api.oviond.comAll API endpoints are versioned under /v1/.
Your First API Call
Check the API is running by hitting the health endpoint:
curl https://api.oviond.com/v1/healthResponse:
{
"success": true,
"data": {
"status": "healthy"
}
}List Available Integrations
Fetch all supported integrations:
curl https://api.oviond.com/v1/integrationsEach integration includes its ID, name, category, authentication type, and available data views.
Query Data
To fetch data from an integration, send a POST request to the query endpoint:
curl -X POST https://api.oviond.com/v1/integrations/{id}/query \
-H "Content-Type: application/json" \
-d '{
"credentials": { "apiKey": "YOUR_API_KEY" },
"profile": { "accountId": "YOUR_ACCOUNT_ID" },
"dataView": "default",
"metrics": ["metric_1", "metric_2"],
"dimension": "dimension_id",
"dateRange": {
"current": { "startDate": "2025-01-01", "endDate": "2025-01-31" },
"previous": { "startDate": "2024-12-01", "endDate": "2024-12-31" }
},
"timezone": "UTC"
}'Next Steps
- Authentication — Learn about credential formats
- Querying Data — Deep dive into the query endpoint
- Error Handling — Handle errors gracefully
- MCP for AI Agents — Connect AI assistants to the API
- Field Reference — Browse all metrics and dimensions
- API Reference — Interactive API playground