Overview
Instacart Ads provides a set of APIs you can use to programmatically and optimize your advertising campaigns in your preferred campaign management solution. With these API endpoints, you can create and manage ad campaigns by setting budgets and Cost per Click (CPC) bids, defining the product(s) you want to sponsor, adding keywords, and retrieving performance data and analytics. The API endpoints can return all the relevant information and analytical data Instacart Ads calculates and tracks, empowering you with the right data to make informed decisions about ad spend and campaign effectiveness.
This section provides a high-level overview of how advertising works on Instacart and the different components involved.
We currently support one type of ad on Instacart— sponsored products (formerly known as featured products). These ads highlight a given product by placing it throughout the customer journey, on the homepage, when they search for related items, as they browse within departments, click on products for details, and in lists of personalized recommendations, hopefully enticing the customer to buy the advertised product.
Instacart Ads also supports bidding on keywords so that when shoppers search for specific keywords, we display your sponsored product.
Each ad has several components which are grouped into a hierarchy to help keep things organized.
At the top, we have campaigns. Each campaign has an objective, a date range, budget, and billing details. It contains one or many ad groups, each of which contains products and, optionally, keywords. Each ad group inherits the campaign’s details— meaning they each use up funds from the campaign’s budget, only run during the campaign’s date range, and are billed according to the campaign’s billing details.
Each ad group contains one or many products and defines a maximum CPC bid. This bid is the amount you are willing to pay for each click on one of the products in this ad group. Entering a higher bid increases the likelihood that your products will be featured in prominent positions for shoppers.
The products the ad group contains represent the different products the Instacart ad features. You can have as many products in an ad group as you want up to a maximum of 5,000. Each product in an ad group gets the same maximum CPC bid and they belong to that ad group’s campaign, with its budget, date range, and billing details.
Optionally, ad groups can contain keywords, up to a maximum of 5,000. These represent bids against specific keywords that customers enter into the search field when shopping. Each keyword has its own bid amount which you pay when customers click on your sponsored product after using the keyword in their search. This enables you to sponsor products against specific search terms or competitors.
Because of how these components are organized and work together, with campaigns containing ad groups and ad groups containing products and keywords, when you’re creating new ads you must create their components in the following order:
- Create a campaign using POST /campaigns.
- Create an ad group in the campaign using POST /ad_groups.
- Create a product in the ad group using POST /ad_groups_products.
- Optionally, create keywords in the ad group using POST /ad_groups_keywords.
- Optionally, create additional ad groups in the campaign or additional products and keywords in any ad group.
Our APIs are REST based and use predictable, resource-oriented URLS and HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients.
API Terms and Conditions
These Instacart API License Terms, which include any policies or terms linked herein, including but not limited to Documentation and Required Minimum Functionality (“Terms” or “Agreement”) govern the license of and Your use of the Instacart application programming interface (“Instacart APIs”) that is designed to permit Your use of such Instacart APIs to create and run promotional campaigns and related services (“Services”) on behalf of Advertisers (defined below) on the Instacart Ads Manager Platform (defined below), and are entered into by You and the applicable Instacart Contracting Party, as defined below (“Instacart” or “We”, “Us”, “Our”). You will be referred to herein as “You” or “Your” or “Yourself” or “Agency”. By using the Services, You agree to be bound by these Terms, as they may be updated by Instacart in its sole discretion from time to time.
These Terms will start on the date You start accessing or using Instacart APIs, and will continue until You stop accessing and using the Instacart APIs, unless ended earlier as described below. By using the Instacart APIs, You (on behalf of Yourself or the business You represent) agree to be bound by the terms of this Agreement, including any applicable additional terms that may apply for each country for which You use the Instacart APIs (in each case, the "Elected Country").Any changes will be effective upon the posting of such changes on the Instacart Ads Manager Platform, or any other Instacart site, and You are responsible for reviewing these locations and informing Yourself of all applicable changes or notices. Changes to these Terms may be made without notice to You. IF ANY CHANGE IS UNACCEPTABLE TO YOU, YOUR ONLY RECOURSE IS TO TERMINATE THIS AGREEMENT BY CEASING USE OF THE INSTACART APIs. YOUR CONTINUED USE OF THE INSTACART APIs FOLLOWING OUR POSTING OF ANY CHANGES WILL CONSTITUTE YOUR ACCEPTANCE OF SUCH CHANGES.
Your use of, or participation in, any program, product, or service offered by Instacart may be subject to additional product-specific terms (“Product-Specific Terms”). In the event of a conflict between this Agreement and any applicable Product-Specific Terms as it relates to the particular program, product, or service covered by the Product-Specific Terms, the Product-Specific Terms will prevail. Nothing in this Agreement shall be construed as limiting Your obligations under any applicable Product-Specific Terms.
If You are accepting these Terms or accessing or using the Instacart APIs on behalf of an entity, You represent and warrant that You have the authority to bind such entity to these Terms and You agree on behalf of such entity to be bound by these Terms.
DEFINITIONS
- “Advertiser” means another person or entity for whom Agency is providing services on the Instacart Ads Manager Platform.
- “Agency Platform” means the platform owned and operated by Agency.
- “Claims” means any and all third party claims, actions, damages, liabilities, and costs, including reasonable attorneys’ fees.
- “End User” means an Instacart customer on the Instacart Platform.
- “Fee” means the service fee payable by Agency to Instacart for Agency’s access and use of the Instacart API.
- “Instacart Contracting Party” means the following party: (a) if Your Elected Country is the United States, then it is Maplebear Inc. d/b/a Instacart, and (b) if Your Elected Country is Canada, then it is Maplebear Canada Inc. d/b/a Instacart.
- “Instacart Data” means any and all data or information provided by Instacart to Agency through the Instacart API or otherwise and any usage data derived from the Services as contemplated under these Terms. No PII shall be exchanged between the parties under these Terms. “Instacart Platform” means the websites and mobile applications owned and operated by Instacart, where End Users shop for groceries and general merchandise.
- “Instacart Ads Manager Platform” means the Instacart CPG self service platform whereby Advertisers or Agencies can create and run promotional campaigns to be run on the Instacart Platform.
- “Required Minimum Functionality” means the scope of integration and other technical requirements for the integration of the Instacart API, as specified below and in the Developer Documentation.
- “Technology” means any and all technology, including inventions (whether or not patentable), discoveries, improvements, methods, processes, information, materials, know-how, trade secrets, works of authorship and other copyrightable materials, data, and algorithms. Agency’s Technology shall include the Agency Platform.
API LICENSE AND SERVICES
Subject to the terms and conditions of these Terms, Agency will integrate the Instacart API with the Agency Platform in accordance with the Required Minimum Functionality. Subject to the terms and conditions of these Terms and any order forms entered into between the Agency and/or its Advertisers and Instacart on the Instacart Ads Manager Platform, Agency shall provide the Services described hereunder for its Advertisers or other services as agreed upon by the parties from time to time.
API and Developer Documentation. Subject to Agency’s compliance with these Terms, Instacart grants Agency a limited, non-exclusive, non-sublicensable, non-transferable, non-assignable license under Instacart’s intellectual property rights (a) to use the Instacart APIs in connection with the Agency Platform solely to provide the Services to Advertisers; and (b) to display the Instacart Data and other materials received from the Instacart APIs within the Agency Platform; provided that the parties agree that the aforementioned license may be sub-licensed by Agency to certain of Agency’s agency clients, so long as such sub-license is mutually agreed upon in advance in writing (email is sufficient). Agency’s use of the Instacart APIs and display of the Instacart Data and other materials must comply with the RMF Requirements described below and all Instacart technical documentation, usage guidelines call volume limits, and other developer documentation (“Developer Documentation”).
Required Minimum Functionality. For any applications that Agency makes available to its Advertisers, Agency must expose at least as much functionality as is set forth Required Minimum Functionality and in this section (“RMF Requirements”). If the RMF Requirements includes a particular function, all aspects of that function and all API calls related to that function must be enabled and exposed. Agency must adhere to any changes made by Instacart to the RMF Requirements and ensure that any additional functionality added to the RMF Requirements are enabled and exposed within a time period established by Instacart in its sole discretion, but in no instance less than ninety (90) days. If Agency does not do so, then Instacart reserves the right to suspend Agency’s access to the Instacart APIs, as set forth below. Agency must provide Instacart a list of metrics displayed to Advertisers and calculation methodology thereof prior to gaining initial access to the Instacart APIs. Further, Agency must notify Instacart, on an ongoing basis, of details of any new metric and calculation methodology thereof to receive an explicit sign off before productionizing it on the Agency Platform.
Support and Feedback. Agency agrees to report to Instacart any errors or difficulties discovered and the characteristic conditions and symptoms of such errors and difficulties. To the extent Agency provides any suggestions or comments related to Instacart APIs or products (“Feedback”), Agency grants to Instacart all legal right, title and interest in the Feedback. Agency understands that Instacart may currently or in the future be developing information internally, or receiving information from other parties that may be similar or nearly identical to Agency’s Feedback or functionality, and each Party understands and agrees that Instacart may continue to use such information.
API License Restriction. Agency shall not (i) disclose or provide the Instacart APIs to any person or entity other than to Agency’s employees or independent contractors who are individuals, provided (a) such employees and independent contractors enter into an agreement with Agency at least as protective of Instacart’s rights as these Terms, and (b) Agency hereby agrees to be responsible for, and liable to Instacart for any breaches of such agreements by Agency’s employees and independent contractors; (ii) use of the Instacart APIs for any illegal, unauthorized or otherwise improper purposes, or in any manner which would violate these Terms or the Developer Documentation, or breach any laws or regulations, or violate the rights of third parties; (iii) remove any of any legal, copyright, trademark or other proprietary rights notices contained in or on materials Agency receives or accesses pursuant to these Terms, including but not limited to, the Instacart APIs, the Developer Documentation, and or any related content; (iv) attempt to sell, lease, share, transfer, sublicense or fail to protect the confidentiality of any content obtained through the Instacart APIs, directly or indirectly, to any third party, including any data broker, ad network, ad exchange, or other advertising monetization-related party; (v) use the Instacart APIs in a manner that violates the Required Minimum Functionality, or otherwise fails to comply or is inconsistent with any part of the Developer Documentation; (vi) attempt to interfere with or disrupt Instacart services or servers or networks connected to Instacart services, or disobey any requirements, procedures, policies or regulations of networks connected to Instacart services, or transmit any viruses, worms, defects, Trojan horses, or any items of a destructive nature through the use of the Instacart APIs; or (vii) attempt to copy adapt, reformat, reverse-engineer, disassemble, decompile, download, translate or otherwise modify the Instacart APIs, content, Instacart’s website, other content or services, or any of our other services, through automated or other means. These Terms do not include any right for Agency to use any trademark, service mark, trade name or any other mark of Instacart or any other party or licensor. No rights or licenses are granted except as expressly and unambiguously set forth herein. The Instacart API and all intellectual property rights embodied therein remain, are and will be the sole and exclusive property of Instacart.
FEES
Agency shall not be charged for access and use of the Instacart API. Any fees associated with the Services provided by Agency on behalf of its Advertisers shall be governed by separate agreements.
DATA USE; SECURITY; CONFIDENTIALITY
Instacart Data License; Data Use Restrictions. Subject to Agency’s compliance with these Terms, Instacart grants to Agency a non-exclusive, non-sublicensable, and non-transferable worldwide right to use the Instacart Data solely to the extent necessary to fulfill Agency’s obligations in connection with providing the Services solely for the benefit of Instacart or the Advertisers pursuant to these Terms. You may not, and may not allow a third party to on Your behalf, scrape the Instacart Ads Manager Platform or any other Instacart property, and You may not indirectly obtain scraped Instacart Data from any third party. If You intend to publish a report that includes Instacart Data obtained from legitimate non-Instacart sources, Your report must disclose the source of the data and Your specific data collection methodologies. You will not use the Instacart Data for any purposes other than as expressly permitted herein. Agency represents and warrants that it shall not make available, display, disclose, transfer, sell, rent, or lease any of Instacart Data without Instacart’s prior written consent. You will not commingle or display non-Instacart data in aggregate with Instacart Data, and shall only display Instacart Data in a manner that is compliant with the RMF Requirements set forth Required Minimum Functionality. You may not use the Instacart APIs to (i) display non-Instacart data in a manner that would lead any person to reasonably attribute such data to Instacart or an Instacart API account, (ii) display any Instacart Data without attributing such Instacart Data to Instacart, or (iii) except with Instacart’s prior written permission in each instance, publish externally facing reports using Instacart data captured from the API. Upon the earlier of (i) the early termination of these Terms or (ii) Agency ceasing to use the Instacart APIs, Agency represents and warrants that it shall delete all Instacart Data in its possession and certify to Instacart of such destruction. For the avoidance of doubt, Agency shall not utilize any Instacart Data for any purpose other than those described in this Section. As between the parties, Instacart retains the sole and exclusive title in and to all Instacart Data.
Data Protection. Agency represents, warrants, and covenants that it has adopted and implemented, and shall maintain, at all times while using the Instacart APIs, a comprehensive written information security program consistent with prevailing industry standards (“Security Program”) that includes administrative, technical, and physical safeguards designed to prevent the unauthorized or accidental access to, destruction, modification, use, or disclosure of Instacart Data and shall act in accordance with the Security Program. Agency shall provide Instacart with information regarding its Security Program and its implementation upon Instacart’s reasonable request. Agency shall promptly notify Instacart if Agency learns or has reason to believe that any person or entity has breached or attempted to breach Agency’s security measures, or gained unauthorized access to Instacart Data (“Information Security Breach”). Upon any such discovery, Agency will (1) investigate, remediate, and mitigate the effects of the Information Security Breach, (2) provide Instacart with any requested information, including detailed information regarding the Information Security Breach, (3) pay for legally required notices to End Users, and (4) provide assurances reasonably satisfactory to Instacart that such Information Security Breach will not recur.
Confidentiality. Through Your use of or access to the Ads Platform Materials (defined below), You may receive data or information relating to us, the Instacart APIs, or the Ads Platform that is not known to the general public (collectively, "Confidential Information"). You agree that: (a) all Confidential Information will remain Instacart’s exclusive property; (b) You will not disclose any Confidential Information to any person or entity other than to Advertiser(s) to which such data or information relates; (c) You will take all reasonable measures to protect the Confidential Information against any use or disclosure that is not expressly permitted in this License Agreement; (d) You will not collect any user information from any Instacart sites or retrieve, extract, index or cache any portion of any Instacart sites, whether through the use of automated applications or otherwise; and (e) You will not use any Confidential Information for any purpose other than creating, managing, and reporting ad campaigns by or on behalf of the particular Advertiser that has expressly authorized You to do so.
REPRESENTATIONS AND WARRANTIES; DISCLAIMER
Agency represents, warrants and covenants that: (a) Agency’s performance hereunder will comply with all applicable laws, rules, and regulations; (b) Agency’s Services will be provided in a professional manner consistent with industry standards by qualified, trained and experienced personnel; (c) Agency’s Services will be original and will not infringe the intellectual property rights, including without limitation patent, trademark, copyright or publicity rights, or other rights of any third party; (d) Agency’s Services are not and have not been subject to any claims of infringement on any grounds; (e) Agency’s Services shall not contain viruses, trojan horses, worms, time bombs, cancelbots drop dead devices, malware, or other similar harmful or deleterious programming routines; (f) Agency’s Services shall not consist of or contain any local shared objects, flash cookies, zombie cookies or other similar tracking devices or technologies that cannot be easily and permanently disabled through all browsers; and (g) it will use the Instacart Platform and Instacart Data only as authorized by these Terms.
EXCEPT AS STATED IN THESE TERMS, THERE ARE NO WARRANTIES, ORAL OR WRITTEN, EXPRESS OR IMPLIED. THERE ARE NO WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. THE INSTACART APIs, INSTACART ADS MANAGER PLATFORM, AND ANY DOCUMENTATION (COLLECTIVELY, “ADS PLATFORM MATERIALS”) ARE PROVIDED "AS-IS." YOUR USE OF THE ADS PLATFORM MATERIALS IS AT YOUR OWN OPTION AND RISK. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, WE DISCLAIM: (A) ANY REPRESENTATIONS OR WARRANTIES REGARDING THIS LICENSE AGREEMENT OR THE PROGRAM MATERIALS, INCLUDING ANY EXPRESS OR IMPLIED WARRANTIES OF MERCHANTABILITY, WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, AND WARRANTIES OF NON-INFRINGEMENT; (B) ANY IMPLIED WARRANTIES ARISING OUT OF COURSE OF DEALING, COURSE OF PERFORMANCE OR USAGE OF TRADE; AND (C) ANY OBLIGATION, LIABILITY, RIGHT, CLAIM OR REMEDY IN TORT, WHETHER OR NOT ARISING FROM OUR NEGLIGENCE. WE DO NOT WARRANT THAT THE PROGRAM MATERIALS WILL MEET YOUR REQUIREMENTS, BE AVAILABLE, SECURE, UNINTERRUPTED OR ERROR-FREE, AND WE WILL NOT BE LIABLE FOR THE CONSEQUENCES OF ANY INTERRUPTIONS OR ERRORS. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, WE DISCLAIM ANY GUARANTEES ABOUT TIMING, POSITIONING, ADJACENCY, PERFORMANCE, QUANTITY OR QUALITY (AS APPLICABLE): PLACEMENTS, TARGETING, IMPRESSIONS, CLICKS, CLICK RATES, CONVERSION RATES, AUDIENCE SIZE, DEMOGRAPHICS OR ADVERTISING COSTS.
INDEMNIFICATION; PROCEDURE
Agency shall indemnify, defend, and hold harmless Instacart and its officers, directors, employees, agents and affiliates (to the extent each was acting in that capacity), from and against any Claims arising out of: (a) Agency’s breach of any representations and warranties in these Terms; (b) any claim that the Agency’s Technology infringes any third party intellectual property rights; (c) Agency’s breach of its obligations in the Confidentiality section of this Agreement; and (d) the gross negligence or willful misconduct of Agency or its employees, contractors, or agents.
If Instacart is seeking indemnification, it will promptly notify Agency of the Claim for which it seeks indemnity and will cooperate with Agency in defending the Claim; provided, however, that failure to provide prompt notice will not excuse Agency’s obligations under this Indemnification Section unless the delay materially prejudices the Agency’s ability to defend the Claim. Agency will have full control and authority over the defense of an indemnified Claim, except that: (a) Agency must not agree to a settlement that imposes any obligation or liability (other than the payment of monetary damages for which indemnity is provided pursuant to this Indemnification Section) on, or that requires an admission of guilt or wrongdoing by, Instacart; and (b) Instacart may participate in the defense at its own expense with counsel of its choice.
LIMITATION OF LIABILITY
TO THE MAXIMUM EXTENT PERMITTED BY LAW, INSTACART WILL NOT BE LIABLE FOR SPECIAL, INDIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES OR LOST PROFITS (HOWEVER ARISING, INCLUDING NEGLIGENCE) ARISING OUT OF OR IN CONNECTION WITH THESE TERMS, EVEN IF IT HAS BEEN ADVISED OF THE POSSIBILITY OF THE DAMAGES. TO THE MAXIMUM EXTENT PERMITTED BY LAW AND EXCEPT FOR ACTIONS ARISING OUT OF INSTACART’S GROSS NEGLIGENCE AND WILLFUL MISCONDUCT, INSTACART’S AGGREGATE LIABILITY ARISING OUT OF OR IN CONNECTION WITH THESE TERMS SHALL NOT EXCEED ONE HUNDRED DOLLARS ($100), REGARDLESS OF THEORY UPON WHICH SUCH LIABILITY IS BASED. EACH PROVISION OF THESE TERMS THAT PROVIDES FOR A LIMITATION OF LIABILITY OR EXCLUSION OF DAMAGES IS TO ALLOCATE THE RISKS OF THESE TERMS BETWEEN THE PARTIES. THIS ALLOCATION IS AN ESSENTIAL ELEMENT OF THE BASIS OF THE BARGAIN BETWEEN THE PARTIES. EACH OF THESE PROVISIONS IS SEVERABLE AND INDEPENDENT OF ALL OTHER PROVISIONS OF THESE TERMS, AND EACH OF THESE PROVISIONS WILL APPLY EVEN IF THESE PROVISIONS FAIL THEIR ESSENTIAL PURPOSE.
INSPECTION RIGHTS; CERTIFICATIONS; SUSPENSION AND TERMINATION OF THE API LICENSE; MODIFICATION OF TERMS
Inspection Rights. Instacart may conduct an inspection on its own, or using a third party subject to confidentiality obligations at least as protective as those in these Terms, at any time. Inspections will be conducted during normal business hours after providing You with at least ten (10) business days’ written notice (email will suffice). Agency will cooperate with the inspections, including by (1) providing all necessary physical and remote access to Your applicable IT systems and records, (2) supplying a username and password to allow Instacart to review Agency Platform, and (3) providing screenshots of the Agency Platform and information and assistance as reasonably requested. If non-compliance is revealed by the inspection, You will be responsible for any third party costs (if any), and must remedy any non-compliance revealed by an inspection as soon as reasonably practicable (as determined by Instacart based on the facts and circumstances, but in no event less than ninety (90) days) and provide written certification of such remediation to Instacart, after which Instacart may conduct follow-up inspections to ensure proper remediation of the non-compliance. If an inspection shows that Agency does not meet the Required Minimum Functionality, Instacart may suspend access to the Instacart APIs in accordance with this section.
Certifications. From time to time, Instacart may request in writing (email is sufficient) information, certifications, and attestations relating to Agency’s use of Instacart APIs, which Agency will provide to us in the requested time frame and form. This may include certifying: (i) Agency’s compliance with these Terms and all other applicable terms and policies, and (ii) Agency’s use of the Instacart Data that Agency has access to, and that each such use complies with these Terms and all other applicable terms and policies. All such certifications and attestations must be provided by an authorized representative of Agency.
Suspension and Termination. We may suspend or terminate (in Instacart’s sole discretion) Your license and access to the Instacart APIs, with or without notice to Agency, if it is determined, in Instacart’s sole discretion, that: (i) Agency has violated any term or condition of these Terms, or the Developer Documentation; (ii) Agency does not comply with the Required Minimum Functionality; (iii) Agency has not timely responded to requests related to inspections; (iv) Agency has commenced a voluntary case or proceeding under the United States Bankruptcy Code or any other federal, state or provincial law relating to insolvency or relief of debtors (“Bankruptcy Laws”); consented to the entry of an order for relief against it in an involuntary case under any Bankruptcy Law; consented to the appointment of a trustee, receiver, or other similar official; made an assignment for the benefit of its creditors; or cannot pay its debts as they become due; or (v) for any or no reason, in Instacart’s sole discretion. Instacart may take enforcement action at any time, including during the investigation of the Agency Platform or Agency’s use of the Instacart APIs, with or without notice to Agency. Enforcement can be both automated and manual. It can include suspending or removing Agency’s access to the Instacart APIs, removing Agency’s access to the Ads Manager Platform, or any other action that Instacart considers to be appropriate. Those obligations, which by their nature should survive the termination of this Agreement, including but not limited to Confidentiality, Indemnification and Limitation of Liability, shall survive the termination of this Agreement. All liabilities that accrued prior to the date on which the expiration or termination of these Terms takes effect will also survive.
Modification. We may amend any of the terms and conditions contained in these Terms (including any RMF Requirements and Documentation at any time and in our sole discretion.
GOVERNING LAW AND VENUE
To the extent the Elected Country is the United States, these Terms will be governed and construed in accordance with the laws of the State of California, without reference to its choice of law rules. Any suit or proceeding relating to these Terms will be brought only in the state courts located in San Francisco County or federal courts located in the Northern District of California. Each of the parties consents to the exclusive personal jurisdiction and venue of such courts.
To the extent the Elected Country is Canada, these Terms will be governed and construed in accordance with the law of the Province of Ontario and the federal laws of Canada applicable therein. Each Party hereto irrevocably agrees that such Agreement, together with matters and disputes arising hereunder or with respect hereto shall be adjudicated by a federal or provincial court within the Province of Ontario having jurisdiction over the matter in dispute and that each such party agrees to voluntarily appear in such forum and submit to its jurisdiction and agrees to not complain as to its convenience.
ASSIGNMENT
Agency shall not assign these Terms nor any rights or obligations under these Terms to a third party, without the prior written consent of Instacart, including in connection with the sale of all or substantially all of Agency’s assets or equity securities by way of stock purchase, asset purchase, merger, or otherwise, to an acquiring third party. Subject to this Assignment Section, in the event an assignment is approved by Instacart, these Terms will be binding upon and will inure to the benefit of the parties and their respective successors and permitted assigns. Any assignment in violation of this Assignment Section will be null and void ab initio.
NOTICES
To the extent the Elected Country is the United States, all notices under these Terms must be given in writing and sent by overnight courier, registered mail, delivered by hand, or via e-mail transmission to Instacart at 50 Beale Street, Suite 600, San Francisco, CA 94105, Attn: General Counsel. Agency must keep contact information with Instacart current, including name, business name, and email. Notices delivered (i) by hand will be deemed received upon delivery, (ii) by overnight courier will be deemed received on the business day following delivery to the courier for overnight service, (iii) by registered mail will be deemed received on the 5th business day following deposit in the mail with sufficient postage affixed, and (iv) by e-mail transmission will be deemed received on the business day following the transmission, provided the sender does not receive a notice of failed delivery (in which case, no notice will be deemed provided).
To the extent the Elected country is Canada, all notices under these Terms must be given in writing and shall be deemed given when delivered by hand or by courier or express mail or by registered or certified Canada Post mail, return receipt requested, postage prepaid, or by facsimile if receipt is acknowledged (except that a notice of termination or default shall not be sent by facsimile) and shall be addressed to Instacart as follows: Maplebear Canada Inc. (d/b/a Instacart), 190 Liberty Street, Toronto, Ontario, M6K 3L5, Attention: General Counsel, With copy to legal@instacart.com. Agency must keep contact information with Instacart current, including name, business name, and email. Notices delivered (i) by hand will be deemed received upon delivery, (ii) by overnight courier will be deemed received on the business day following delivery to the courier for overnight service, (iii) by registered mail will be deemed received on the 5th business day following deposit in the mail with sufficient postage affixed, and (iv) by e-mail transmission will be deemed received on the business day following the transmission, provided the sender does not receive a notice of failed delivery (in which case, no notice will be deemed provided).
NO THIRD PARTY BENEFICIARIES
Except as may be expressly provided in these Terms, the terms of these Terms are intended solely for the benefit of the parties and are not intended to confer on any other person the status of a third party beneficiary.
FORCE MAJEURE
No party to these Terms will be liable to the other party for any failure or delay in fulfilling an obligation under these Terms, if that failure or delay is attributable to circumstances beyond its control, including any fire, power failure, labor dispute, war, or dispute.
SEVERABILITY
If any term, condition, or provision in these Terms is found to be invalid, unlawful, or unenforceable to any extent, the invalid term, condition, or provision will be severed from the remaining terms, conditions, and provisions of these Terms, which will continue to be valid and enforceable to the fullest extent permitted by law.
INTERPRETATION; MISCELLANEOUS
The headings appearing at the beginning of the Sections contained in these Terms have been inserted for reference purposes only and must not be used to construe or interpret these Terms. Any reference to any agreement, document, or instrument will mean such agreement, document, or instrument as amended or modified and in effect from time to time in accordance with the terms thereof. Whenever the words “include,” “includes,” or “including” are used in these Terms, they will be deemed to be followed by the words “without limitation.” Whenever the words “hereunder,” “hereof,” “hereto,” and words of similar import are used in these Terms, they will be deemed references to these Terms as a whole and not to any particular Section, or other provision hereof. The word “or” is used in the inclusive sense of “and/or.” The terms “or,” “any” and “either” are not exclusive.
If the Elected Country is Canada, then it is the express wish of the parties that this Agreement and the applicable Product-Specific Policies have been drafted in English. (The following is a French translation of the preceding sentence: Si le pays choisi est le Canada, les parties souhaitent expressément que la présente convention ainsi que les politiques spécifiques au produit soient rédigées en anglais.) The English-language version of this Agreement, including the Product-Specific Policies, if any, is the definitive legal version.
PUBLICITY
Neither party shall at any time use the name, trademark(s), or trade name(s) of the other party in any advertising or publicity, or announce or publish in any form or through any channel that Agency has agreed to these Terms, without the prior written consent of the other party for each such use, which consent may be withheld by the party in its sole discretion.
LAST UPDATED 10.18.21
Required Minimum Functionality
For any applications that Agency makes available to its Advertisers, Agency must expose at least as much functionality as is set forth in the below table and in this section (“RMF Requirements”). If the RMF Requirements includes a particular function, all aspects of that function and all API calls related to that function must be enabled and exposed. Agency must adhere to any changes made by Instacart to the RMF Requirements and ensure that any additional functionality added to the RMF Requirements are enabled and exposed within a time period established by Instacart in its sole discretion, but in no instance less than ninety (90) days. If Agency does not do so, then Instacart reserves the right to suspend Agency’s access to the Instacart APIs, as set forth in Section 9 below. Agency must provide Instacart a list of metrics displayed to Advertisers and calculation methodology thereof prior to gaining initial access to the Instacart APIs. Further, Agency must notify Instacart, on an ongoing basis, of details of any new metric and calculation methodology thereof to receive an explicit sign off before productionizing it on the Agency Platform.
| Relevant to "Campaign Management for external use" Apps | Relevant to "Reporting-Only" Apps | ||
|---|---|---|---|
| Area | Feature | Advertisers, agencies, and/or other third parties use your tool to fully manage their Instacart Ads Manager accounts | Only a reporting dashboard available to end-advertisers |
| App setup | Enable authorizing/de-authorizing App access to API | X | X |
| Campaign Setup | Enable Bid adjustment by adgroup or keywords | X | |
| Campaign Setup | Enable Campaign Budget setting and adjustment | X | |
| Campaign Setup | Enable Campaign duration (start/end date if applicable) | X | |
| Campaign Setup | Enable Turn campaign off/on | X | |
| Campaign Setup | Add Products to campaign | X | |
| Targeting | Enable choosing budget profile (Daily budget vs Max impressions) | X | |
| Targeting | Enable targeting additional keywords | X | |
| Recommendations | Show Bid recommendations | X | |
| Recommendations | Show Budget recommendations if shared | X | |
| Reporting | Show Campaign/Ad group status | X | X |
| Reporting | Show Campaign performance at campaign level | X | X |
| Reporting | Show Campaign performance at adgroup level | X | X |
| Reporting | Show Campaign performance at UPC product level | X | X |
| Reporting | Show Campaign performance at keyword level | X | X |
| Reporting | Show ROAS Metric and associated calculation | X | X |
| Reporting | Show Total Spend | X | X |
| Reporting | Show Impressions Metric | X | X |
| Reporting | Show Clicks | X | X |
| Reporting | Show CTR Metric | X | X |
| Reporting | Show Attributed Sales Spend | X | X |
| Reporting | Show Attributed Quantities | X | X |
| Reporting | Show Total Average CPC | X | X |
| Reporting | Explain IC attribution windows | X | X |
| Reporting | Make advertiser aware of any delays in reporting | X | X |
| User interface & reporting | Transition all notations of 'Featured Product' to 'Sponsored Product', Discontinue any usage of 'Featured Product'. | X | X |
| Versioning | Abide by Versioning definition and Versioning Lifecycle, including upgrading from deprecated to current Ads API version within a 12 week timeframe | X | X |
| Breaking Changes | Abide by Breaking Change definition | X | X |
| Campaign Setup | Optimized Bidding enabled for campaign management | X |
Last Updated: Oct. 4, 2022.
API Status
Available at https://enterprise-status.instacart.com. Here we will post our most-up-to-date information about the availability of business and mission critical Instacart Ads services.
Versioning
Introduction
The Instacart Ads API uses major versioning to support breaking, non-backwards compatible changes. Major versions are defined like 'Version 2.0'.
Each new Ads API version will have a separate endpoint, changelog and release notes.
Instacart Ads has Breaking & Non-Breaking Change definitions to provide a concise methodology for when a new API Version will be deployed to support Breaking Changes. Adherence to Instacart’s Versioning and Breaking Change definitions are required as part of the Required Minimum Functionality of our Ads API.
Breaking & Non-Breaking Change Definitions
Breaking Change
A breaking change is defined as a change that harms the workflow or integration of a partner’s application causing it to cease functioning as intended. Breaking changes are non-backwards compatible.
Breaking changes include, but are not limited to:
- Removal or renaming of a service, interface, field, method or enum value
- Addition of new required request parameters or report fields
- Changes to the field type
- Changes to existing response field values
- Changes to the format of response data
- Changes to the format of endpoint URLs
- Changes to the format of a resource name
- Changes to the default value of request or response field
- Changes to HTTP status codes
- Changes to an error reason
Non-breaking Change
A non-breaking change is defined as a backwards compatible change that introduces additive functionality to an existing endpoint. Such changes are supplemental to the existing information, can be implemented at the partner’s own pace, and do not restrict or break the partner’s integration.
Non-breaking changes include, but are not limited to:
- New endpoints
- Addition of new request parameters, response fields, or report fields
- Changes to the order of response or report fields
- Changes to error message text
- New optional request headers
- New optional values returned for existing response fields. For example, a new campaign status
Versioning Definition
A new Ads API version will be introduced when a ‘Breaking Change’ is released. Only two versions of the Ads API will be live at once, current and deprecated. A beta version of the Ads API will live in the sandbox environment for initial testing before it becomes the new current Ads API version.
Versioning Lifecycle
A version of the Instacart Ads API has three lifecycle stages:
Beta Version
- This is a temporary version that is only available on the Sandbox environment for external API testing purposes
- This version will not be available on production for external API integrations
- A Beta version will have a public API specification, Changelog, and Release Notes describing what's new and altered
- This version has a minimum lifecycle of 4 weeks for testing purposes only
Current Version
- This version will be available on production for external API integrations
- The current version will receive all bug fixes, and time constrained features that do not include breaking changes (i.e., we need to release functionality earlier than when the next version will move to ‘Current’)
- This version has a minimum lifecycle of 12 weeks
Deprecated Version
- This is the version of the API that will be sunset. Partner notices will be sent when a version is planned to be sunset
- The only code changes to this version are critical bug fixes and critical security updates
- This version has a maximum lifecycle of 12 weeks
- API partners are expected to upgrade their deprecated API version to the current API version within a 12 week period, per the Required Minimum Functionality of the Instacart Ads API
Version 3
The API is accessible at https://api.ads.instacart.com/api/v3.
Documentation for V3 is available here.
See the new release notes here.