> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get looking similar

> Retrieve similar looking recommendations for an object ID, based on image attributes.

export const Legacy = ({title, href}) => {
  return <Note>

    This page documents an earlier version of the API client.
    For the latest version, see <a href={href}>{title}</a>.

    </Note>;
};

<Legacy title="Retrieve recommendations" href="/doc/libraries/sdk/methods/recommend/get-recommendations" />

**Required ACL:** `search`

<Note>
  This method is only available in the JavaScript API client.
</Note>

## Examples

```js JavaScript icon=code theme={"system"}
recommendClient
  .getLookingSimilar([
    {
      indexName: "INDEX_NAME",
      objectID: "your_object_id",
    },
  ])
  .then(({ results }) => {
    console.log(results);
  })
  .catch((err) => {
    console.log(err);
  });
```

## Parameters

<ParamField body="requests" type="object[]" required>
  <Expandable>
    <ParamField body="indexName" type="string" required>
      Name of the target index.
    </ParamField>

    <ParamField body="objectID" type="string" required>
      Object ID of the item for which to get recommendations.
    </ParamField>

    <ParamField body="threshold" type="number" required>
      Threshold for the recommendations' confidence score (between 0 and 100).
      Only recommendations with a score greater than the threshold are returned.
    </ParamField>

    <ParamField body="fallbackParameters" type="object">
      [Search parameters](/doc/api-reference/search-api-parameters) to use as fallback when there are no recommendations,
      except: `page`, `hitsPerPage`, `offset`, `length`.
    </ParamField>

    <ParamField body="maxRecommendations" type="integer">
      Maximum number of recommendations to retrieve.
      Depending on the available recommendations and the other request parameters, the actual number may be lower.
      If `maxRecommendations` isn't provided or set to 0,
      all matching recommendations are returned,
      and no fallback request is performed.
    </ParamField>

    <ParamField body="queryParameters" type="object">
      [Search parameters](/doc/api-reference/search-api-parameters) for filtering the recommendations,
      except: `page`, `hitsPerPage`, `offset`, `length`.
    </ParamField>
  </Expandable>
</ParamField>

## Response

<ResponseField name="results" type="object[]">
  List of results in the order they were submitted, one per query.

  **Example:**

  ```jsonc JSON icon=braces theme={"system"}
  {
    "results": [
      {
        "hits": [
          {
            // ...
            "_score": 32.72
          }
        ],
      },
    ]
  }
  ```

  <Expandable>
    <ResponseField name="_score" type="number">
      The confidence score of the recommended item. The closer it is to 100, the more relevant.
    </ResponseField>
  </Expandable>
</ResponseField>

### Response as JSON

This section shows the JSON response returned by the API.
Each API client wraps this response in language-specific objects, so the structure may vary.
To view the response, use the `getLogs` method.
Don't rely on the order of properties—JSON objects don't preserve key order.

```jsonc JSON icon=braces theme={"system"}
{
  "results": [
    {
      "hits": [
        {
          "_highlightResult": {
            "category": {
              "matchLevel": "none",
              "matchedWords": [],
              "value": "Men - T-Shirts"
            },
            "image_link": {
              "matchLevel": "none",
              "matchedWords": [],
              "value": "https://example.org/image/D05927-8161-111-F01.jpg"
            },
            "name": {
              "matchLevel": "none",
              "matchedWords": [],
              "value": "Jirgi Half-Zip T-Shirt"
            }
          },
          "_score": 32.72,
          "category": "Men - T-Shirts",
          "image_link": "https://example.org/image/D05927-8161-111-F01.jpg",
          "name": "Jirgi Half-Zip T-Shirt",
          "objectID": "D05927-8161-111",
          "position": 105,
          "url": "men/t-shirts/d05927-8161-111"
        }
      ],
      "processingTimeMS": 1,
    }
  ]
}
```