---
title: "Configure a localized API push"
slug: "configure-a-localized-api-push"
abstract: "How to configure an API push source to handle index documents in two locales."
---
# Configure a localized API push

The API push [source](https://doc.sitecore.com/search/en/users/search-user-guide/index-items.html "Index items") is a source configuration to create and maintain indexes exclusively for content you push to Sitecore Search. After you configure an API push source, a developer uses the [Ingestion API](https://doc.sitecore.com/search/en/developers/search-developer-guide/using-the-ingestion-api-to-add-content-to-an-index.html) to add documents to the API push source's index.

> [!important]
> To index localized versions of non-crawlable content, you need an API push source.

For example, assume that your content is on a social networking-type site that consists exclusively of visitor-generated content. Visitors create, update, and delete content every few seconds. To ensure that the latest content is always searchable, you can create an API push source and, in your application, have a developer set up a webhook that calls the API every time content is created, updated, or deleted.

Refer to our recommended best practices to [index](https://doc.sitecore.com/search/en/users/search-user-guide/index-items/best-practices-for-indexing.html "Best practices for indexing") and [crawl complete websites](https://doc.sitecore.com/search/en/users/search-user-guide/index-items/best-practices-for-indexing/best-practices-to-crawl-complete-websites.html "Best practices to crawl complete websites").

This walkthrough describes how to:

:::walkthrough
1. [Create an API push source](https://doc.sitecore.com/search/en/users/search-user-guide/index-items/configure-indexing/configure-a-localized-api-push.html#create-an-api-push-source)
2. [Configure available locales](https://doc.sitecore.com/search/en/users/search-user-guide/index-items/configure-indexing/configure-a-localized-api-push.html#configure-available-locales)
3. [Publish updates to the source](https://doc.sitecore.com/search/en/users/search-user-guide/index-items/configure-indexing/configure-a-localized-api-push.html#publish-updates-to-the-source)
:::

## Create an API push source

You have to create a source before you can configure it.

To create a source:

1. On the menu bar, click **Sources**.
2. Click ![Plus_add__grey.png](https://doc.sitecore.com/api/markdown-image/search/en/users/search-user-guide/images/Plus_add__grey.png) **Add Source**.
3. In the **SOURCE NAME** field, enter a name for the source.

    For example, enter *Blog push source*.

4. In the **DESCRIPTION** field, enter a few lines to describe the source you want to configure.

    For example, enter *Push source for rush content for English and French*.

5. In the **CONNECTOR** field, click **API Push** as the type of source you want to create.
6. Click **Save**. If there are no errors, Search creates a new source.

## Configure available locales

Configure available locales to define the subset of domain languages you want to use for the source. All sources have English (US) as the default locale. You can add locales or edit the default locale using the following procedure.

> [!important]
> To ensure stable ingestion, [do not include more than 30 locales](https://doc.sitecore.com/search/en/users/search-user-guide/index-items/configure-indexing/optimizing-search.html "Optimizing Search") per API push source.

To configure locales:

1. On the **Source Settings** page, click ![pencil_grey.png](https://doc.sitecore.com/api/markdown-image/search/en/users/search-user-guide/images/pencil_grey.png) **Edit** next to **Available Locales**.
2. On the **Available Locales** page, click inside the **LOCALES** field to see a list of locales available for this domain, and then the locale you want.
3. Click **Save**.

## Publish updates to the source

You must publish the API push source before you can use the Ingestion API to create index documents and add them to this index.

To publish the source:

1. On the Source Settings page, click **Publish**.
2. In the dialog box that asks you to confirm whether you want to publish the source, click **Publish**.

Now, a developer can use the [Ingestion API](https://doc.sitecore.com/search/en/developers/search-developer-guide/en/walkthrough--creating-and-updating-index-documents-in-two-locales-using-the-ingestion-api.html) to create, update, and later, even delete, index documents for this source.