Find object

Find an object by the given condition. Can be used to debug relevance.

Required ACL: search

Use this method to debug the relevance of a specific record. This method accepts a condition and returns the first matching object along with its position information in the result set.

The findObject method uses search internally so it can also retrieve the position for a given query. To retrieve an object, use the more efficient getObjects method instead.

Examples

C#

index.FindObject<Employee>(
  hit => hit.Firstname.Equals("Jimmie"),
  new Query());

// With a query
index.FindObject<Employee>(
  hit => hit.Firstname.Equals("Jimmie"),
  new Query("query string"));

// With a query and only in the first page
index.FindObject<Employee>(
  hit => hit.Firstname.Equals("Jimmie"),
  new Query("query string"),
  false);

f := func(o map[string]interface{}) bool {
    itf, ok := o["firstname"]
    if !ok {
        return false
    }
    firstname, ok := itf.(string)
    return ok && firstname == "Jimmie"
}

index.FindObject(f, "", true)

// With a query
index.FindObject(f, "query string", true)

// With a query and only in the first page
index.FindObject(f, "query string", false)

index.findObject(
    x -> x.getFirstName().equals("Jimmie"),
    new Query(""));

// With a query
index.findObject(
    x -> x.getFirstName().equals("Jimmie"),
    new Query("query string"));

// With a query and only in the first page
index.findObject(
    x -> x.getFirstName().equals("Jimmie"),
    new Query("query string"),
    false);

index.findObject(hit => hit.firstname == "Jimmie")
  .then(obj => {
    console.log(obj);
  });

// With a query
index.findObject(hit => hit.firstname == "Jimmie", {
  query: "query string"
}).then(obj => {
  console.log(obj);
});

// With a query and only in the first page
index.findObject(hit => hit.firstname == "Jimmie", {
  query: "query string",
  paginate: false
}).then(obj => {
  console.log(obj);
});

val match: (ResponseSearch.Hit) -> Boolean = {
    it.json.getPrimitive("firstname").content == "Jimmie"
}
index.findObject(match)
index.findObject(match, Query("query string"))
index.findObject(match, Query("query string"), paginate = false)

$index->findObject(function($obj) {
  return array_key_exists('firstname', $obj) && 'Jimmie' === $obj['firstname'];
});

// With a query
$options1 = [ 'query' => 'query string' ];
$index->findObject(function($obj) {
  return array_key_exists('firstname', $obj) && 'Jimmie' === $obj['firstname'];
}, $options1);

// With a query and only the first page
$options2 = [ 'query' => 'query string', 'paginate' => false ];
$index->findObject(function($obj) {
  return array_key_exists('firstname', $obj) && 'Jimmie' === $obj['firstname'];
}, $options2);

result = index.find_object(lambda hit: hit.get('firstname') == 'Jimmie')

# With a query
result = index.find_object(lambda hit: hit.get('firstname') == 'Jimmie', {
    'query': 'query string'
})

# With a query and only in the first page
result = index.find_object(lambda hit: hit.get('firstname') == 'Jimmie', {
    'query': 'query string',
    'paginate': False
})

object = index.find_object(->(obj) { obj.key?('firstname') and obj['firstname'] == 'Jimmie' })

# With a query
object = index.find_object(->(obj) { obj.key?('firstname') and obj['firstname'] == 'Jimmie' }, {
  'query' => 'query string'
})

# With a query and only in the first page
object = index.find_object(->(obj) { obj.key?('firstname') and obj['firstname'] == 'Jimmie' }, {
  'query' => 'query string',
  'paginate' => false
})

helper.findObject(
  indexName,
  Query(),
  (e: Employee) => e.firstName == "jimmie")

// With a query
helper.findObject(
  indexName,
  Query(query = Some("query string")),
  (e: Employee) => e.firstName == "jimmie"))

// With a query and only in the first page
helper.findObject(
  indexName,
  Query(query = Some("query string")),
  (e: Employee) => e.firstName == "jimmie",
  paginate = false)

let predicate: (JSON) -> Bool = { hit in
  return hit["firstname"] == "Jimmie"
}

index.findObject(matching: predicate) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

// With a query
index.findObject(matching: predicate, for: Query("query string")) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

// With a query and only in the first page
index.findObject(matching: predicate,
                 for: Query("query string"),
                 paginate: false) { result in
  if case .success(let response) = result {
    print("Response: \(response)")
  }
}

Parameters

callback · function · required

The callback used to find the object.

index · string · required

Scala only: the name of the index to query.

paginate · boolean · default: true

Whether to paginate the search results.

query · string

The query used to search.

requestOptions · object

A mapping of request options, when using this method.

Response

object · object

The hit matching your callback.

A hit is made of the schemaless JSON object that you stored in the index.

However, Algolia enriches them with additional fields like _highlightResult.

Example:

JSON

object: {
    field1 : "",
    field2 : "",
    [...],

    _highlightResult: {
      [...]
    }
}

page · integer

Number of the current page (zero-based). See the page search parameter.

position · integer

Number of the matching object’s position in the result set (zero-based).

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.

JSON

{
  "object": {
    "firstname": "Jimmie",
    "lastname": "Barninger",
    "_highlightResult": {
      "firstname": {
        "value": "<em>Jimmie</em>",
        "matchLevel": "partial"
      },
      "lastname": {
        "value": "Barninger",
        "matchLevel": "none"
      },
      "company": {
        "value": "California <em>Paint</em> & Wlpaper Str",
        "matchLevel": "partial"
      }
    }
  },
  "position": 0,
  "page": 0
}