Api Documentation Overview: The Causality Engine API enables ingestion of marketing events, retrieval of attribution results, and integration with external systems.
Read the full article below for detailed insights and actionable strategies.
API Purpose
Our API facilitates programmatic access to Causality Engine’s features:
Event data ingestion (online/offline conversions)
Attribution result querying
Report generation
Authentication
Use API keys to authenticate requests. Generate and manage keys in your dashboard.
Endpoints Overview
POST /events: Send marketing events with user and channel data.
GET /attribution: Retrieve attribution summaries and channel incrementality.
GET /reports: Access automated report exports.
Data Formats
All requests and responses use JSON. Include mandatory fields such as:
event_type
timestamp
user_id or anonymous_id
channel identifiers
Rate Limits
API limits ensure service stability. Contact support for higher throughput needs.
Error Handling
Standard HTTP status codes indicate success or failure. Error responses include descriptive messages.
Best Practices
Batch events where possible to sharpen throughput.
Validate data before sending to avoid ingestion errors.
Secure API keys and rotate regularly.
For detailed endpoint specs and examples, consult your dashboard’s API section.
See also Marketing Attribution concepts for background.
Related Resources
Customer Success and Support: We Are Here to Help
Subscription vs One Time Analysis: Which Is Right for You
Get attribution insights in your inbox
One email per week. No spam. Unsubscribe anytime.
Key Terms in This Article
Attribution
Attribution identifies user actions that contribute to a desired outcome and assigns value to each. It reveals which marketing touchpoints drive conversions.
Causality
Causality is the relationship where one event directly causes another, essential for identifying specific actions that drive desired outcomes in marketing.
Channel
A Channel is a medium for delivering marketing messages to potential customers.
Conversion
Conversion is a specific, desired action a user takes in response to a marketing message, such as a purchase or a sign-up.
Customer Success
Customer Success ensures customers achieve their desired outcomes using a company's product or service. It builds relationships, provides solutions, and drives satisfaction, retention, and growth.
Dashboard
A dashboard is a visual display of key information required to achieve specific objectives. It consolidates data onto a single screen for quick review.
Incrementality
Incrementality measures the true causal impact of a marketing campaign. It quantifies the additional conversions or revenue directly from that activity.
Marketing Attribution
Marketing attribution assigns credit to marketing touchpoints that contribute to a conversion or sale. Causal inference enhances attribution models by identifying true cause-effect relationships.
Ready to see your real numbers?
Upload your GA4 data. See which channels drive incremental sales. Confidence-scored results in minutes.
Book a DemoFull refund if you don't see it.
Stay ahead of the attribution curve
Weekly insights on marketing attribution, incrementality testing, and data-driven growth. Written for marketers who care about real numbers, not vanity metrics.
No spam. Unsubscribe anytime. We respect your data.
Frequently Asked Questions
How do I authenticate API requests?
Include your API key in the Authorization header as a bearer token.
Can I upload offline conversion events via the API?
Yes, the `POST /events` endpoint supports offline event ingestion.
What is the typical API response time?
Responses usually return within 200-500 ms depending on request complexity.
Is there an API sandbox environment?
Yes, a sandbox is available for testing without affecting production data.
How do I request increased rate limits?
Contact support with your use case to discuss quota enhancements.
