Skip to main content
Instacart logo

​
Overview

Add Instacart to any ModuleX agent or workflow. Public Instacart actions: build shareable recipe + shopping-list pages and look up retailers by postal code. No API key required.
Categories: E-Commerce · Business Services · Grocery · Retail · Shopping · Auth: ModuleX Managed · Actions: 3

​
Authentication

​
ModuleX Managed

This integration uses Instacart’s public APIs. No API key is required for requests.

​
Available Actions

​
Parameters

​
title
string
required
The title of the recipe
​
ingredients
array
required
List of ingredients for the recipe
​
instructions
string
Recipe instructions/directions
​
servings
integer
Number of servings
​
image_url
string
URL to recipe image
​
source_url
string
Original recipe source URL
​
partner_id
string
Partner ID for affiliate tracking

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "shareable_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Shareable Url"
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Title"
    },
    "ingredient_count": {
      "default": 0,
      "title": "Ingredient Count",
      "type": "integer"
    },
    "ingredients": {
      "items": {
        "type": "string"
      },
      "title": "Ingredients",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateRecipePageOutput",
  "type": "object"
}

​
Parameters

​
title
string
required
The title of the shopping list
​
items
array
required
List of items to add to the shopping list
​
partner_id
string
Partner ID for affiliate tracking

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "shareable_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Shareable Url"
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Title"
    },
    "item_count": {
      "default": 0,
      "title": "Item Count",
      "type": "integer"
    },
    "items": {
      "items": {
        "type": "string"
      },
      "title": "Items",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateShoppingListPageOutput",
  "type": "object"
}

​
Parameters

​
postal_code
string
required
Postal/ZIP code to search near
​
country_code
string
Country code (e.g., ‘US’, ‘CA’) (Default: US)

​
Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "postal_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Postal Code"
    },
    "country_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Country Code"
    },
    "retailer_count": {
      "default": 0,
      "title": "Retailer Count",
      "type": "integer"
    },
    "retailers": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Retailers",
      "type": "array"
    },
    "store_finder_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Store Finder Url"
    },
    "message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Message"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetNearbyRetailersOutput",
  "type": "object"
}

​
Limits & Quotas

  • Recipe/list pages are pure URL builders (no API hit).
  • Retailer lookup goes to Instacart’s public /v3/retailers endpoint; on timeout or non-200 the tool returns a store-finder URL as a usable fallback (still success=True).
  • Country supported: US, CA.

Amazon Selling Partner

Coinbase

Etsy