---
title: "Search cocktails"
method: GET
path: "/api/v1/cocktails"
tags: ["Cocktails"]
---

# Search cocktails

`GET /api/v1/cocktails`

## Request

- Base URL: `https://api.instadram.me/v1`
- URL: `https://api.instadram.me/v1/api/v1/cocktails`
- Auth: none declared

## Query parameters

- `q` string
- `limit` integer
- `offset` integer
- `spirit_type` string

## Response `200`

List of cocktails

- object
  - `success` boolean
  - `data` Cocktail[]
    - `id` string: Cocktail ID
    - `name` string: Cocktail name
    - `ingredients` string[]: List of ingredients
    - `instructions` string: Preparation instructions
    - `glassware` string: Recommended glassware
    - `garnish` string: Garnish
    - `website_url` string: Source website URL
    - `image_url` string: Cocktail image URL
    - `source` string: Source name
    - `spirit_types` string[]: Types of spirits used
    - `created_at` string, date-time: Creation timestamp
  - `pagination` Pagination
    - `total_count` integer: Total number of items
    - `limit` integer: Number of items per page
    - `offset` integer: Number of items to skip
    - `page` integer: Current page number
    - `total_pages` integer: Total number of pages
    - `has_next` boolean: Whether there is a next page
    - `has_prev` boolean: Whether there is a previous page

---

[API](https://skmtc.dev/instadram/apis/instadram-api.md) · [All operations](https://skmtc.dev/instadram/apis/instadram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instadram/apis/instadram-api/revisions/2971df0f7ef1?raw)