Carrot Ads API
The Carrot Ads API provides retailers with a comprehensive advertising solution that enables them to do the following:
- Monetize their digital storefronts.
- Deliver personalized, relevant ads to shoppers while maintaining a seamless shopping experience.
- Access sponsored products, display placements, brand pages, and detailed performance metrics through Instacart's API.
What can you build with Carrot Ads API?
- Sponsored product placements. Display promoted products in search results and category pages, helping brands increase product visibility and drive sales.
- Display advertising. Serve banner ads and promotional content across your storefront, creating additional revenue streams while maintaining user experience.
- Brand pages. Create custom branded shopping experiences that showcase a brand's full product catalog and promotional content.
- Performance tracking and analytics. Monitor ad impressions, clicks, conversions, and revenue with comprehensive event tracking and reporting capabilities.
Carrot Ads API overview
| API Suite | Purpose | Key Use Cases |
|---|---|---|
| Advertising APIs | Ad delivery and display management. | Sponsored products, display placements, brand pages. |
| Tracking APIs | Event monitoring and attribution. | Track impressions, clicks, conversions, and order data. |
| Reporting APIs | Performance metrics and revenue analytics. | View ad performance, revenue reports, and campaign metrics. |
Developer resources
When you are ready to begin building, the following documentation resources can help you get started.
| Category | Resource | Description |
|---|---|---|
| Authentication | Get an access token | Authentication setup and token management. |
| Getting Started | Implement Carrot Ads API | Step-by-step implementation guide. |
| Concepts | Sponsored Products | Understanding sponsored product ads. |
| Concepts | Placement Ads | Display advertising concepts and formats. |
| Concepts | Brand Pages | Custom branded shopping experiences. |
| Concepts | Ad Events | Event tracking types and implementation. |
| Concepts | Metrics | Performance measurement and reporting. |
| API Reference | Get Sponsored Products | Retrieve sponsored product ads for display. |
| API References | Get Display Placements | Fetch display ad placements. |
| API References | Get Brand Page | Retrieve brand page content and products. |
| API References | Track Ad Events | Log impressions, clicks, and conversions. |
| API References | Ingest Orders | Submit order data for attribution tracking. |
| API Updates | Changelog | Track all updates, new features, and improvements. |
| Technical Support | FAQs | Frequently asked questions and troubleshooting. |
| Technical Support | Request technical support | Submit technical support requests. |
| Technical Support | Enterprise service desk | Contact Instacart Technical Support. |
Next steps
- Get authenticated. Follow the tutorial to obtain your access token and start making API calls.
- Implement ad formats. Choose from sponsored products, display placements, or brand pages that are based on your monetization strategy.
- Set up tracking. Implement event tracking to measure ad performance and optimize revenue.