<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/marketplace-search-configurations",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Marketplace Search Configurations"
}
-->

# Marketplace Search Configurations

Add and read information for alternative marketplace search configurations.

## Discussion

Alternative marketplaces can use a sitemap that uses an industry-standard specification, with additional features specified by Apple. To learn more about the data structure for the sitemap, see [Building a searchable catalog for your marketplace app for inclusion in Spotlight](/documentation/AppStoreConnectAPI/building-a-searchable-catalog-for-your-marketplace-app-for-inclusion-in-spotlight). To add the URL for this sitemap to [Applebot](https://support.apple.com/en-us/HT204683) web crawler use the [`Add a marketplace search detail url`](/documentation/AppStoreConnectAPI/POST-v1-marketplaceSearchDetails) endpoint.

## Topics

### Managing search URLs

[Building a searchable catalog for your marketplace app for inclusion in Spotlight](/documentation/AppStoreConnectAPI/building-a-searchable-catalog-for-your-marketplace-app-for-inclusion-in-spotlight)

Set up and build your alternative marketplace’s searchable index.

[`Add a marketplace search detail url`](/documentation/AppStoreConnectAPI/POST-v1-marketplaceSearchDetails)

Add a search detail URL for the alternative marketplace.

[`Read the marketplace search detail url`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-marketplaceSearchDetail)

Get search detail URL for the alternative marketplace.

[`Get the marketplace search detail ID for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-relationships-marketplaceSearchDetail)

[`Modify a marketplace search detail url`](/documentation/AppStoreConnectAPI/PATCH-v1-marketplaceSearchDetails-_id_)

Update the search detail URL for the alternative marketplace.

[`Delete a marketplace search detail url`](/documentation/AppStoreConnectAPI/DELETE-v1-marketplaceSearchDetails-_id_)

Delete search detail URL for the alternative marketplace.

### Objects

[`MarketplaceSearchDetail`](/documentation/AppStoreConnectAPI/MarketplaceSearchDetail)

The search configuration for an alternative marketplace, specifying how apps are indexed and surfaced in search.

[`MarketplaceSearchDetailCreateRequest`](/documentation/AppStoreConnectAPI/MarketplaceSearchDetailCreateRequest)

The request body you use to create an alternative marketplace search detail.

[`MarketplaceSearchDetailResponse`](/documentation/AppStoreConnectAPI/MarketplaceSearchDetailResponse)

A response containing the search configuration for a single alternative marketplace.

[`MarketplaceSearchDetailUpdateRequest`](/documentation/AppStoreConnectAPI/MarketplaceSearchDetailUpdateRequest)

The request body you use to update an alternative marketplace search detail.

[`AppMarketplaceSearchDetailLinkageResponse`](/documentation/AppStoreConnectAPI/AppMarketplaceSearchDetailLinkageResponse)


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)