Instacart

Learn how to use Instacart with Composio

Overview

SLUG: INSTACART

Description

Instacart Developer Platform APIs to create shoppable lists/recipes and discover nearby retailers

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Instacart toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["INSTACART"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Create Recipe Page

Description

Create a recipe page on instacart + return shareable url. attempts prod first then falls back to dev; errors from prod bubble up if both fail.

Action Parameters

expires_in
integer
image_url
string
ingredients
arrayRequired
instructions
array
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Shopping List Page

Description

Create a shopping list page on instacart + return shareable url. attempts prod first then falls back to dev; errors from prod bubble up if both fail.

Action Parameters

expires_in
integer
image_url
string
instructions
string
line_items
arrayRequired
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Nearby Retailers

Description

Get nearby retailers by postal code + country code. attempts prod first then falls back to dev; errors from prod bubble up if both fail.

Action Parameters

country_code
stringRequired
postal_code
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired