API Reference / API Methods / Advanced / Set extra header

Nov. 12, 2020

Set Extra Header

Required API Key: no ACL required

Method signature

$config = \Algolia\AlgoliaSearch\Config\SearchConfig::create('YourApplicationID', 'YourAdminAPIKey');
$config->setDefaultHeaders([
  headerName => string headerValue
]);

$client = \Algolia\AlgoliaSearch\SearchClient::createWithConfig($config);

config = Algolia::Search::Config.create('YourApplicationID', 'YourAdminAPIKey')
config.set_extra_header(String headerName, String headerValue)

client = Algolia::Search::Client.create_with_config(config)

algoliasearch('YourApplicationID', 'YourAdminAPIKey', {
  headers: {
    headerName: string headerValue
  }
})

config = SearchConfig('YourApplicationID', 'YourAdminAPIKey')
config.headers[headerName] = str headerValue

client = SearchClient.create_with_config(config)

let configuration = SearchConfiguration(applicationID: "YourApplicationID", apiKey: "YourAdminAPIKey")
  .set(\.defaultHeaders, to: [headerName: headerValue]: [HTTPHeaderKey: String]?)

data class ConfigurationSearch(
    val applicationID: ApplicationID,
    val apiKey: APIKey,
    val defaultHeaders: MutableMap<String, String> = mutableMapOf()
) : Configuration

client.setHeader(String headerName, String headerValue)

var configuration = new SearchConfig(
  "YourApplicationID",
  "YourAdminAPIKey"
)
{
    DefaultHeaders = new Dictionary<string, string>
    {
      { String headerName, String headerValue }
    }
};

SearchClient client = new SearchClient(configuration);

SearchConfig configuration =
    new SearchConfig.Builder("YourApplicationID", "YourAdminAPIKey")
      .addExtraHeaders(String headerName,  String headerValue)
      .build();

search.NewClientWithConfig(search.Configuration{
  AppID: "YourApplicationID",
  APIKey: "YourAdminAPIKey",
  Headers: map[string]string{
    string headerName: string headerValue,
  },
})

new AlgoliaClient(
  "YourApplicationID",
  "YourAdminAPIKey",
  customHeader = Map(
    headerName -> String headerValue
  )
)

See code examples

About this method

You are currently reading the JavaScript API client v4 documentation. Check our migration guide to learn how to upgrade from v3 to v4. You can still access the v3 documentation.

You are currently reading the Ruby API client v2 documentation. Check our migration guide to learn how to upgrade from v1 to v2. You can still access the v1 documentation.

Sends an extra http header to Algolia, for all subsequent queries.

This method allows you to send the server a specific key/value pair - that we call an extra http header, with every query. By doing this, you are giving the api an additional header that it can later use in certain situations.

Here are some headers with different use cases:

Setting X-Algolia-UserToken for API key rate limiting purposes.
Setting X-Algolia-UserToken for analytics purposes. The Analytics API uses the provided value to distinguish between end users. It takes priority over any value in X-Forwarded-For. Use this header if you need to forward the end user’s identity without relying on IP addresses.
Setting X-Forwarded-For for analytics purposes. If your server sends the end user’s IP along with every search, this lets analytics distinguish between end users. Otherwise, the analytics uses the server’s IP address, which doesn’t provide the detail of each user. Alternatively, see X-Algolia-UserToken below.
Setting X-Forwarded-For for geo purposes. This ensures that the geo search location uses the IP address of the end user, and not that of your back-end server. For an example of this, see the aroundLatLngViaIP parameter.

This will eventually be replaced by the requestOptions parameter, allowing you to set the header as part of your query parameters.

Examples

Copy

1
2
3
4
5
6
$config = \Algolia\AlgoliaSearch\Config\SearchConfig::create('YourApplicationID', 'YourAdminAPIKey');
$config->setDefaultHeaders([
  'headerName => 'headerValue'
]);

$client = \Algolia\AlgoliaSearch\SearchClient::createWithConfig($config);

1
2
3
4
config = SearchConfig('YourApplicationID', 'YourAdminAPIKey')
config.headers['NAME-OF-HEADER'] = 'value-of-header'

client = SearchClient.create_with_config(config)

1
2
3
4
let configuration = SearchConfiguration(applicationID: "YourApplicationID", apiKey: "YourAdminAPIKey")
  .set(\.defaultHeaders, to: ["NAME-OF-HEADER": "value-of-header"])

let client = SearchClient(configuration: configuration)

1
2
3
4
5
6
var configuration = new SearchConfig("YourApplicationID", "YourAdminAPIKey")
{
    DefaultHeaders = new Dictionary<string, string> { { "NAME-OF-HEADER", "value-of-header" } }
};

SearchClient client = new SearchClient(configuration);

1
2
3
4
5
6
SearchConfig configuration =
new SearchConfig.Builder("YourApplicationID", "YourAdminAPIKey")
  .addExtraHeaders("NAME-OF-HEADER", "value-of-header")
  .build();

SearchClient client = DefaultSearchClient.create(configuration);

1
2
3
4
5
6
7
8
9
config := search.Configuration{
  AppID:  "YourApplicationID",
  APIKey: "YourAdminAPIKey",
  Headers: map[string]string{
    "NAME-OF-HEADER": "value-of-header",
  },
}

client := search.NewClientWithConfig(config)

1
2
3
4
5
6
7
``kotlin
val configuration = ConfigurationSearch(
    applicationID = ApplicationID("YourApplicationID"),
    apiKey = APIKey("YourAdminAPIKey"),
    defaultHeaders = mapOf("NAME-OF-HEADER" to "value-of-header")
)
ClientSearch(configuration)

Parameters

`headerName`	type: string Required Name of the header to add.
`headerValue`	type: string Required Value of the header to add.

Response

No response

Building Search UI

Building Search UI

Building Search UI

Building Search UI

Building Search UI

Building Search UI

PHP

Ruby

JavaScript

Python

Swift

Kotlin

Android

.NET

Java

Golang

Scala

InstantSearch.js

React InstantSearch

Vue InstantSearch

Angular InstantSearch

InstantSearch iOS

InstantSearch Android

Autocomplete

Crawler Configuration API

Index settings and search parameters

A full reference of API Endpoints

Rails

Symfony

Django

Laravel

Crawler

Magento 2

WordPress

Shopify

Salesforce Commerce Cloud B2C

Netlify

Set Extra Header

About this method

Examples

Parameters

Response

Did you find this page helpful?

On this page