Api clients / JavaScript / V3 / Methods

Jan. 09, 2023

Browse Index | JavaScript API Client V3 (Deprecated)

This version of the JavaScript API client has been deprecated in favor of the latest version of the JavaScript API client.

Required API Key: any key with the browse ACL

Method signature

index.browseAll(string query, object browseParameters)

index.browse(string query, callback)
index.browse(string query, object browseParameters, callback)

See code examples

About this method

Get all index content without any record limit. Can be used for backups.

The browse method is an alternative to the Search index method. If you need to retrieve the full content of your index (for backup, SEO purposes or for running a script on it), you should use this method instead.

Results are ranked by attributes and custom ranking.

But for performance reasons, there is no ranking based on:

distinct
typo-tolerance
number of matched words
proximity
geo distance

You shouldn’t use this method for building a search UI.
The analytics API does not collect data from browse method usage.
If you need to retrieve more than 1,000 results, you should look into the paginationLimitedTo setting.

Examples

Browse an index (recommended way)

This example shows how to iterate over the whole index:

Copy

Copy
// Empty query will match all records
$iterator = $index->browseObjects(['query' => '', 'filters' => 'i<42']);

foreach ($iterator as $hit) {
  var_dump($hit);
}

Copy
const browser = index.browseAll();
let hits = [];

browser.on('result', content => {
  hits = hits.concat(content.hits);
});

browser.on('end', () => {
  console.log('Finished!');
  console.log('We got %d hits', hits.length);
});

browser.on('error', err => {
  throw err;
});

// You can stop the process at any point with
// browser.stop();

Copy
let query = Query(query: "") // Empty query will match all records
query.filters = "i<42"
index.browse(query: query, completionHandler: { (content, error) -> Void in
    if error == nil {
        print("Result: \(content!)")
    }
})

Copy
BrowseIterator iterator = new BrowseIterator(index, query, new BrowseIterator.BrowseIteratorHandler() {
  @Override
  public void handleBatch(@NonNull BrowseIterator iterator, JSONObject result, AlgoliaException error) {
    // Handle the result/error. [...]
    // You may optionally cancel the iteration by calling:
    iterator.cancel();
  }
});
iterator.start();

Copy
IndexIterator<T> indexIterator = index.Browse<T>(new BrowseIndexQuery { Filters = "i<42"});

var hits = new List<T>();

foreach (var hit in indexIterator)
{
    hits.Add(hit);
}

Copy
it, err := index.BrowseObjects(
    opt.Query(""),
    opt.Filters("i<42"),
)

// You can either retrieve an empty interface for each object or pass a
// struct object as a parameter of the Next() call, which will try to
// deserialize the object directly.
var interfaceObject interface{}
var structObject struct { ... }

for {
    if interfaceObject, err = it.Next(&structObject); err != nil {
        if err == io.EOF {
            // End of results
        } else {
            // Error while browsing
        }
        break
    }
    fmt.Println(structObject)
}

Browse an index and send extra HTTP headers

Copy

Copy
$searchParameters = [];

$iterator = $index->browseObjects([
  'query' => '', // Empty query will match all records
  'filters' => 'i<42',
  'X-Forwarded-For' => '94.228.178.246'
]);

foreach ($iterator as $hit) {
  var_dump($hit);
}

Copy
query = '' # Empty query will match all records

extra_headers = {
  'X-Forwarded-For': '94.228.178.246'
}

index.browse({ query: query, filters: 'i=42' }, nil, extra_headers) do |hit|
  puts hit
end

Copy
client.setExtraHeader('X-Forwarded-For', '94.228.178.246');
const browser = index.browseAll();
let hits = [];

browser.on('result', content => {
  hits = hits.concat(content.hits);
});

browser.on('end', () => {
  console.log('Finished!');
  console.log('We got %d hits', hits.length);
});

browser.on('error', err => {
  throw err;
});

// You can stop the process at any point with
// browser.stop();

Copy
query = '' # Empty query will match all records

res = index.browse_objects({
    'query': query,
    'filters': 'i<42',
    'X-Forwarded-For': '94.228.178.246'
})

for hit in res:
    print(hit)

Copy
let requestOptions = RequestOptions()
requestOptions.headers["X-Algolia-User-ID"] = "user123"
let query = Query(query: "") // Empty query will match all records
query.filters = "i<42"
index.browse(
  query: query,
  requestOptions: requestOptions,
  completionHandler: { (content, error) -> Void in
    if error == nil {
        print("Result: \(content!)")
    }
  }
)

Copy
BrowseIterator iterator = new BrowseIterator(
  index,
  query,
  new RequestOptions()
    .setHeader("X-Algolia-User-ID", "94.228.178.246"),
  new BrowseIterator.BrowseIteratorHandler() {
    @Override
    public void handleBatch(
      @NonNull BrowseIterator iterator,
      JSONObject result,
      AlgoliaException error) {
        // Handle the result/error. [...]
        // You may optionally cancel the iteration by calling:
        iterator.cancel();
    }
  }
);

iterator.start();

Copy
var requestOptions = new RequestOptions
{
    Headers = new Dictionary<string,string>{ { "X-Algolia-User-ID", "userID1" } }
};

IndexIterator<T> indexIterator = index.BrowseFrom<T>(new BrowseIndexQuery { Filters = "i<42" }, requestOptions);

foreach (var hit in indexIterator)
{
    Console.WriteLine(hit.ToString());
}

Copy
List<T> hits = new ArrayList<>();

IndexIterable<T> indexIterable = index.browse(
  new BrowseIndexQuery().setFilters("i<42"),
  new RequestOptions().addExtraHeader("X-Algolia-User-ID", "user123"));

for (T hit : indexIterable)  {
  hits.add(hit);
}

Copy
it, err := index.BrowseObjects(
    opt.Query(""),
    opt.Filters("i<42"),
    opt.ExtraHeaders(map[string]string{"X-Algolia-User-ID", "userID1"})
)

// You can either retrieve an empty interface for each object or pass a
// struct object as a parameter of the Next() call, which will try to
// deserialize the object directly.
var interfaceObject interface{}
var structObject struct { ... }

for {
    if interfaceObject, err = it.Next(&structObject); err != nil {
        if err == io.EOF {
            // End of results
        } else {
            // Error while browsing
        }
        break
    }
    fmt.Println(structObject)
}

Copy
val syncHelper = AlgoliaSyncHelper(client)
val q = Query(query = Some("text"), filters = Some("i<42"))
syncHelper
  .browse("myIndex", q, RequestOptions(
    extraHeaders = Some(Map("X-Algolia-User-ID" => "user123"))
  )
  .map(println)

Copy
val query = Query(query = "")
val requestOptions = requestOptions {
    header("X-Algolia-User-ID", "user123")
}

index.browseObjects(query, requestOptions).forEach { responseSearch ->
    println(responseSearch.hits)
}

Parameters


            query

type: string

Required

Query to search. Accepts every character and every character entered will be used in the search.

Empty query can be used to fetch all records.


            browseParameters

type: key value mapping

default: No browse parameters

Optional

Browse compatible search parameters.

Can contain any of the search parameters except the following, which will be overridden by the engine:

typoTolerance will be forced to true - records matching up to 2 typos will be retrieved
distinct will be forced to false
ignorePlurals will be forced to false
advancedSyntax will be forced to false
facets will be forced to []
getRankingInfo will be forced to false
attributesToHighlight will be forced to []
attributesToSnippet will be forced to []


            requestOptions

type: key value mapping

default: No request options

Optional

A mapping of [`requestOptions`](/doc/api-client/getting-started/request-options/) to send along with the query.

Response

In this section we document the JSON response returned by the API. Each language will encapsulate this response inside objects specific to the language and/or the implementation. So the actual type in your language might differ from what is documented.

JSON format

Copy

        {
  "hits": [
    {
      "firstname": "Jimmie",
      "lastname": "Barninger",
      "objectID": "433"
    }
  ],
  "processingTimeMS": 7,
  "query": "",
  "params": "filters=level%3D20",
  "cursor": "ARJmaWx0ZXJzPWxldmVsJTNEMjABARoGODA4OTIzvwgAgICAgICAgICAAQ=="
}

      

`hits`	list Retrieved records.
`cursor`	string A cursor to retrieve the next chunk of data. Used with `browseFrom`. If absent, it means that the end of the index has been reached.
`params`	string URL-encoded search parameters used to filter the results.
`query`	string Query text used to filter the results.
`processingTimeMS`	integer Time that the server took to process the request, in milliseconds. This does not include network time.
`nbHits`	integer Number of objects in the index. Present only when the query is empty and the browse is not filtered.
`page`	integer Index of the current page (zero-based). Present only when the query is empty and the browse is not filtered.
`hitsPerPage`	integer The maximum number of hits returned per page. Present only when the query is empty and the browse is not filtered.
`nbPages`	integer The number of returned pages. Calculation is based on total number of hits (nbHits) divided by the number of hits per page (hitsPerPage), rounded to the nearest highest integer. Present only when the query is empty and the browse is not filtered.

Did you find this page helpful?