---
title: Add a marketplace search detail url
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/post-v1-marketplacesearchdetails
---

# Add a marketplace search detail url

Add a search detail URL for the alternative marketplace.

## URL

POST https://api.appstoreconnect.apple.com/v1/marketplaceSearchDetails

## Response Codes

201 Created: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 409 Conflict: 422 : 429 :

## Mentioned in

Building a searchable catalog for your marketplace app for inclusion in Spotlight App Store Connect API 3.3 release notes Configuring alternative marketplaces and alternative marketplace apps

## Discussion

Discussion Example Request and Response

## See Also

### Managing search URLs

- [Building a searchable catalog for your marketplace app for inclusion in Spotlight](appstoreconnectapi/building-a-searchable-catalog-for-your-marketplace-app-for-inclusion-in-spotlight.md)
- [Read the marketplace search detail url](appstoreconnectapi/get-v1-apps-_id_-marketplacesearchdetail.md)
- [Get the marketplace search detail ID for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-marketplacesearchdetail.md)
- [Modify a marketplace search detail url](appstoreconnectapi/patch-v1-marketplacesearchdetails-_id_.md)
- [Delete a marketplace search detail url](appstoreconnectapi/delete-v1-marketplacesearchdetails-_id_.md)