Search across multiple entity types

This endpoint provides a unified search interface that searches across multiple entity types in your library using Elasticsearch. You can search for ingredients, recipes, images, albums, menus, recipe albums, purchase orders, stock items, supplier packages, and invoices all in a single request.

Search Query

The q parameter is required for the search to return results. If not provided, the endpoint will return empty results for all entity types.

Entity Type Filtering

Use the entity_types parameter to limit your search to specific entity types. Provide a comma-separated list of valid entity types:

ingredients - Search ingredients
recipes - Search recipes
images - Search images
albums - Search image albums
menus - Search menus
recipe_albums - Search recipe albums
purchase_orders - Search purchase orders
stock_items - Search stock items
supplier_packages - Search supplier packages
invoices - Search invoices

If entity_types is not provided, the search will include all available entity types.

Pagination

Results are paginated using the page and page_size parameters:

page: Page number starting at 1 (default: 1)
page_size: Number of results per page, maximum 200 (default: 15)

Response Structure

The response is organized by entity type, with each type containing:

items: Array of matching items with relevant attributes
count: Number of matching items found

Each item includes a pk (primary key) and a detail_url when available, which can be used to fetch full details of the item.

Search Behavior

The search uses Elasticsearch's full-text search capabilities with n-gram analysis, allowing for flexible matching:

Prefix matching (e.g., "chick" matches "chicken")
Infix matching (e.g., "ken" matches "chicken")
Exact matching for precise queries

Results are sorted by relevance score, with the most relevant matches appearing first.