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.
Customer journey
The customer journey last-click attribution misses
One conversion. Five touchpoints. Last-click credits the final touch with 100%.
Last-click attribution
Every other channel gets zero credit, even though they created the demand.
Causal inference
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.
Conversion
Conversion is a specific, desired action a user takes in response to a marketing message, such as a purchase or a sign-up.
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.
Related Articles
Sixty-second versions of these ideas: Causality Engine on YouTube Shorts.
Ready to see your real numbers?
Own the budget? Upload your GA4 export and see which channels drive incremental sales, with confidence intervals, in minutes. Have to defend it? Start with the live demo and take the read to your CFO.
Full refund if you don't see value.
Stay ahead of the attribution curve
Weekly insights on marketing attribution, incrementality testing, and data-driven growth. Written for the person who owns the budget and the person who has to defend it.
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.