Food Search gives you food discovery, media lookup, and conversational food responses in one API. Send a search query, image URL, or text prompt, and get structured results back for recipes, menu items, grocery products, videos, trivia, jokes, and chatbot answers.
Use /food/search to search across food content with query, and optionally number and offset. Use /food/site/search to look up site content by query across Recipes, Articles, Menu Items, and Grocery Products. For richer discovery, /food/videos/search supports query plus filters like diet, type, cuisine, includeIngredients, excludeIngredients, minLength, maxLength, number, and offset, returning video metadata and totalResults.
If you work with images, /food/images/classify accepts an imageUrl and returns a category with probability. /food/images/analyze also takes imageUrl, and returns nutrition, category, and matching recipes. For text-based workflows, /food/detect accepts a body with text and returns annotations, while /food/converse and /food/converse/suggest provide answerText, media, suggests, and words for food-focused chat flows.
You can also generate lightweight engagement content with /food/trivia/random and /food/jokes/random, both returning a single text field. This makes Food Search useful for recipe apps, content sites, assistants, and product experiences that need food search, classification, and conversational output without building the logic yourself.
Get a random food trivia fact.
curl -X GET "https://api.eu.apyhub.com/skycraft/food-search-trivia-api/food/trivia/random" \
-H "apy-token: $APY_TOKEN"Returns a JSON object with a required text string field containing the trivia fact.
{
"text": "Bananas are berries, but strawberries are not."
}Loading your default key…Returns a random food trivia item as a JSON object.
Returns a JSON object with a text string field containing the trivia text. Success response shape: 200 OK.
| Parameter | Type | Description |
|---|---|---|
| text | String | The trivia text. Must be a non-empty string. |
Fetch a random food joke with your API token.
curl -X GET "https://api.eu.apyhub.com/skycraft/food-search-trivia-api/food/jokes/random" \
-H "apy-token: $APY_TOKEN"Returns a JSON object with a text string field containing the joke.
{
"text": "Why did the tomato turn red? Because it saw the salad dressing."
}Loading your default key…Returns a random food joke as a JSON object containing a single text string.
Returns a JSON object with a text string field containing the joke text.
| Parameter | Type | Description |
|---|---|---|
| text | String | The joke text. |
Use the query parameter to get food conversation suggestions.
curl -X GET "https://api.eu.apyhub.com/skycraft/food-search-trivia-api/food/converse/suggest?query=tell" \
-H "apy-token: $APY_TOKEN"Returns a JSON object with two top-level fields: suggests and words.
words is an array of strings.suggests is an object with a required _ field, where _ is an array of objects; each object contains a name string.{
"suggests": {
"_": [
{
"name": "pizza"
}
]
},
"words": [
"pizza",
"pasta"
]
}Loading your default key…Returns conversation suggestion data for a given query string. The endpoint accepts a query parameter input and responds with a JSON object containing suggests and words.
| Attribute | Type | Description |
|---|---|---|
| query | String | Search text to generate suggestions from. |
| number | Number | Number of suggestions to return. |
Returns a JSON object with two top-level fields: suggests is an object, and words is an array of strings. The success response shape is defined by the schema and includes nested suggestion entries under suggests._.
| Attribute | Type | Description |
|---|---|---|
| suggests | Object | Object containing the _ array of suggestion items. |
| suggests._ | Object Array | Array of suggestion objects. Each item includes a name string field with at least 1 character. |
| suggests._[].name | String | Suggestion name. |
| words | String Array | Array of strings related to the response. |
Classify a food image by passing its image URL as a query parameter.
curl -X GET "https://api.eu.apyhub.com/skycraft/food-search-trivia-api/food/images/classify?imageUrl=https://assets.apyhub.com/samples/recipe.jpg" \
-H "apy-token: $APY_TOKEN"Returns a JSON object with a category string and a probability number.
{
"category": "pizza",
"probability": 0.98
}Loading your default key…Classifies an image from a URL and returns the predicted food category together with a probability score.
| Attribute | Type | Description |
|---|---|---|
| imageUrl | String | The image URL to classify. |
Returns a JSON object with two top-level fields: category as a string and probability as a number. The category is the predicted classification label, and probability is the associated score.
| Parameter | Type | Description |
|---|---|---|
| category | String | Predicted classification label. |
| probability | Number | Probability score for the classification. |
Analyze a food image by passing its image URL as a query parameter.
curl -X GET "https://api.eu.apyhub.com/skycraft/food-search-trivia-api/food/images/analyze?imageUrl=https://assets.apyhub.com/samples/recipe.jpg" \
-H "apy-token: $APY_TOKEN"Returns a JSON object with three top-level fields: nutrition (an object with nutrition estimates), category (an object with the predicted food category), and recipes (an array of matching recipe objects).
{
"nutrition": {
"recipesUsed": 0,
"calories": {
"value": 0,
"unit": "kcal",
"confidenceRange95Percent": { "min": 0, "max": 0 },
"standardDeviation": 0
},
"fat": {
"value": 0,
"unit": "g",
"confidenceRange95Percent": { "min": 0, "max": 0 },
"standardDeviation": 0
},
"protein": {
"value": 0,
"unit": "g",
"confidenceRange95Percent": { "min": 0, "max": 0 },
"standardDeviation": 0
},
"carbs": {
"value": 0,
"unit": "g",
"confidenceRange95Percent": { "min": 0, "max": 0 },
"standardDeviation": 0
}
},
"category": {
"name": "dessert",
"probability": 0.98
},
"recipes": []
}Loading your default key…Analyzes an image provided by URL and returns identified category information, nutrition estimates, and matching recipes. The request takes the image URL as a query parameter.
| Attribute | Type | Description |
|---|---|---|
| imageUrl | String | URL of the image to analyze. |
Returns a JSON object with three required top-level fields: nutrition (object), category (object), and recipes (array of objects).
| Attribute | Type | Description |
|---|---|---|
| nutrition | Object | Nutrition analysis object containing recipesUsed and estimates for calories, fat, protein, and carbs. |
| category | Object | Detected food category, including name and probability. |
| recipes | Object Array | Array of recipe objects, each containing id, title, imageType, and url. |
Ask the endpoint a food-related question by passing the required text query parameter.
curl -X GET "https://api.eu.apyhub.com/skycraft/food-search-trivia-api/food/converse?text=donut%20recipes" \
-H "apy-token: $APY_TOKEN"Returns a JSON object with an answerText string and a media array. answerText contains the reply text, and each item in media is an object that may include link, image, and title.
{
"answerText": "Here are some donut recipes you can try.",
"media": [
{
"link": "https://example.com/donut-recipes",
"title": "Donut recipes"
}
]
}Loading your default key…Sends a text query to the chatbot and returns a JSON object containing the chatbot’s answer text and any related media entries.
| Attribute | Type | Description |
|---|---|---|
| text | String | The text prompt to send to the chatbot. |
| contextId | String | An optional context identifier to continue or reference a prior conversation. |
Returns a JSON object with an answerText string field and a media array field. answerText contains the chatbot’s response text, and media contains zero or more media objects.
| Parameter | Type | Description |
|---|---|---|
| answerText | String | The chatbot’s answer text. |
| media | Object Array | An array of media objects associated with the response. |
| media[].link | String | A link associated with the media item. |
| media[].image | String | An image value associated with the media item. |
| media[].title | String | The media item’s title. |
Search for foods by query string using the required query parameter.
curl -X GET "https://api.eu.apyhub.com/skycraft/food-search-trivia-api/food/search?query=apple" \
-H "apy-token: $APY_TOKEN"Returns a JSON object with query (string), totalResults (integer), limit (integer), offset (integer), and searchResults (array). searchResults contains objects with name and totalResults, and each result item may include fields like id, link, name, type, image, content, kvtable, and relevance.
{
"query": "apple",
"totalResults": 1,
"limit": 10,
"offset": 0,
"searchResults": [
{
"name": "Apple",
"totalResults": 1,
"results": [
{
"id": 1,
"name": "Apple"
}
]
}
]
}Loading your default key…Searches the food catalog for items matching a query string and returns a JSON object with the search metadata and grouped search results. The response includes the original query, totalResults, limit, offset, and a searchResults array.
| Attribute | Type | Description |
|---|---|---|
| query | String | Search term to look up. |
| number | Integer | Number of results to return per page. Default: 10; minimum: 1; maximum: 100. |
| offset | Integer | Zero-based result offset for pagination. Minimum: 0; maximum: 900. |
Returns a JSON object with query (string), totalResults (integer), limit (integer), offset (integer), and searchResults (array) fields.
| Parameter | Type | Description |
|---|---|---|
| query | String | The query string used for the search. |
| totalResults | Integer | Total number of matching results. |
| limit | Integer | The result limit applied in the response. |
| offset | Integer | The result offset applied in the response. |
| searchResults | Object Array | Array of grouped search result objects. Each item includes name and totalResults, and may include a results array. |
| searchResults[].name | String | Group name. |
| searchResults[].totalResults | Integer | Total number of results in the group. |
| searchResults[].results | Object Array | Array of result objects. Each item may include id, link, name, type, image, content, kvtable, and relevance. |
| searchResults[].results[].id | Integer | Result identifier. |
| searchResults[].results[].link | String | Result link. Nullable in the schema. |
| searchResults[].results[].name | String | Result name. |
| searchResults[].results[].type | String | Result type. |
| searchResults[].results[].image | String | Result image. |
| searchResults[].results[].content | String | Result content. Nullable in the schema. |
| searchResults[].results[].kvtable | String | Key-value table data. |
| searchResults[].results[].relevance | Number | Result relevance score. |
Search for food-related matches by query string.
curl -X GET "https://api.eu.apyhub.com/skycraft/food-search-trivia-api/food/site/search?query=past" \
-H "apy-token: $APY_TOKEN"Returns a JSON object with four required top-level arrays: Articles, Grocery Products, Menu Items, and Recipes. Each array contains result objects with at least a name field, and may also include id, link, type, image, content, kvtable, and relevance.
{
"Articles": [],
"Grocery Products": [],
"Menu Items": [],
"Recipes": []
}Loading your default key…Searches site content for the supplied query string and returns matching results grouped into four arrays: Recipes, Articles, Menu Items, and Grocery Products.
| Attribute | Type | Description |
|---|---|---|
| query | String | Search term to match against site content. |
Returns a JSON object with four required array fields: Articles, Grocery Products, Menu Items, and Recipes. Each array contains objects with site-content result details, and each item is required to include name.
| Parameter | Type | Description |
|---|---|---|
| Articles | Object Array | Matching article results. Each item includes name and may also include id (Integer), link (String, nullable), type (String), image (String), content (String, nullable), kvtable (String), and relevance (Number). |
| Grocery Products | Object Array | Matching grocery product results. Each item includes name and may also include id (Integer), link (String, nullable), type (String), image (String), content (String, nullable), kvtable (String), and relevance (Number). |
| Menu Items | Object Array | Matching menu item results. Each item includes name and may also include id (Integer), link (String, nullable), type (String), image (String), content (String, nullable), kvtable (String), and relevance (Number). |
| Recipes | Object Array | Matching recipe results. Each item includes name and may also include id (Integer), link (String, nullable), type (String), image (String), content (String, nullable), kvtable (String), and relevance (Number). |
Search for food-related videos with a required query string.
curl -X GET "https://api.eu.apyhub.com/skycraft/food-search-trivia-api/food/videos/search?query=burger" \
-H "apy-token: $APY_TOKEN"Returns a JSON object with videos and totalResults fields. videos is an array of video objects, and each video includes title, length, rating, shortTitle, thumbnail, views, and youTubeId; totalResults is the total number of matching videos.
{
"videos": [
{
"title": "How to Make a Burger",
"length": 180,
"rating": 4.8,
"shortTitle": "Burger",
"thumbnail": "https://example.com/thumb.jpg",
"views": 125000,
"youTubeId": "abc123"
}
],
"totalResults": 1
}Loading your default key…Searches for food-related videos using query parameters and returns a JSON object containing matching videos plus the total number of results.
| Attribute | Type | Description |
|---|---|---|
| diet | String | Dietary preference filter. |
| type | String | Recipe/video type filter. |
| query | String | Search query term. |
| number | Integer | Number of results to return. Default: 10. Minimum: 1, maximum: 100. |
| offset | Integer | Result offset for pagination. Minimum: 0, maximum: 900. |
| cuisine | String | Cuisine filter. |
| maxLength | Number | Maximum video length. |
| minLength | Number | Minimum video length. |
| excludeIngredients | String | Ingredients to exclude. |
| includeIngredients | String | Ingredients to include, comma-separated. |
Returns a JSON object with a videos array and a totalResults integer field. The videos array contains video objects, each with title, views, length, rating, thumbnail, youTubeId, and shortTitle fields.
| Parameter | Type | Description |
|---|---|---|
| videos | Object Array | Array of video objects. Each item includes title (String), views (Integer), length (Integer), rating (Number), thumbnail (String), youTubeId (String), and shortTitle (String). |
| totalResults | Integer | Total number of matching videos. |
bad_requestRequired parameter missing or malformed body.
unauthorizedAPI key missing, revoked, or not authorized for this service.
rate_limitedYour plan's per-second rate exceeded. Retry with exponential backoff.
upstream_busyBackend temporarily unavailable. Try again in a few seconds.
Closest matches in the catalog based on this service.
Reads that touch this API.
