Foods: Autocomplete search expression v2*


Returns a list of suggestions for the expression specified.

Why are we introducing this version?

This version contains an update to the JSON output structure.

Localization (Premier Only):

Two additional optional parameters named region and language are available to premier clients. More information can be found in the Localization guide.

Note: foods.autocomplete.v2 only works for the default region / language combination.



Name Type Description
method String MUST be "foods.autocomplete.v2"
expression String Suggestions for the given expression is returned. E.G.: "chic" will return up to four of the best suggestions that contains "chic".


Name Type Description
format String The desired response format. Valid reponse formats are "xml" or "json" (default value is "xml").
max_results Int The maximum number of results to return (default value is 4). This number cannot be greater than 10.


The result of the call is the best suggestions matching the expression specified, ordered by their relevency to the expression. Up to four suggestions are returned.

Example Return XML

<?xml version="1.0" encoding="utf-8" ?>
<suggestions xmlns="" xmlns:xsi="" xsi:schemaLocation="">
    <suggestion>chicken breast</suggestion>
    <suggestion>chicken salad</suggestion>
    <suggestion>chiken wings</suggestion>

Example Return JSON

{ "suggestions": { "suggestion": [ "chicken", "chicken breast", "chicken salad", "chiken wings" ] }}

Error Code

Code Description
13 Invalid token: "<detail>"
101 Missing required parameter: "<detail>"
107 Value out of range: "<detail>"
FatSecret Sites
For Developers

For Professionals

For Everyone

FatSecret Platform API



About FatSecret

© 2023 FatSecret. All rights reserved.