v1Ressourcen/Locations/postStandort erstellen
Standort erstellen
Erstellt einen Standort, unter einem Ihrer Kunden (clientId) oder eigenständig, und übermittelt ihn zur Veröffentlichung. Erfordert name, countryIso und eine Kategorie: categoryId, categoryName oder publisherCategories.google.
post
locations:write/api/v1/locationsAnfragetext
clientIdstringoptional
ID des Kunden, unter dem dieser Standort erstellt werden soll. Nachschlagen mit GET /api/v1/clients. Optional, wie „Ohne Kunden“ in der App: Lassen Sie sie weg, wird der Standort eigenständig angelegt. Ein Schlüssel, der auf bestimmte Kunden beschränkt ist, muss eine senden.
kindstring (location | website)optional
location (the default) is a physical business listing. website is a website entity — a brand's site tracked for reviews, SEO, AEO and social — created from a name and a website alone. It is not a billable location, and it needs website entities enabled for the workspace (403 otherwise).
namestringerforderlich
Der Firmenname des Standorts.
countryIsostringoptional
ISO-Ländercode, z. B. US.
streetstringoptional
Straßenadresse.
street1stringoptional
Straßenadresse, Zeile 2.
citystringoptional
Stadt.
stateIsostringoptional
Code für Bundesland oder Region.
postalCodestringoptional
Postleitzahl.
phonestringoptional
Telefonnummer.
additionalPhonesarray of stringoptional
Weitere Telefonnummern zusätzlich zur primären.
websitestringoptional
Website-URL.
categoryIdstringoptional
ID der allgemeinen Kategorie, aus GET /api/v1/locations/categories. Ein Standort braucht eine Kategorie: Senden Sie dies, categoryName oder publisherCategories.google.
categoryNamestringoptional
Anzeigename der allgemeinen Kategorie. Ein Standort braucht eine Kategorie: Senden Sie dies, categoryId oder publisherCategories.google. Ein Name, der nicht im Katalog steht, wird als Anzeigekategorie übernommen.
publisherCategoriesobjectoptional
Kategorien pro Publisher, eine pro Publisher, jeweils ein { id, name }, nachgeschlagen über GET /api/v1/locations/publisher-categories. Beim Erstellen erfüllt publisherCategories.google auch die Kategorie-Anforderung.
googleobjectoptional
idstringoptional
namestringoptional
facebookobjectoptional
idstringoptional
namestringoptional
appleobjectoptional
idstringoptional
namestringoptional
bingobjectoptional
idstringoptional
namestringoptional
additionalCategoriesarray of objectoptional
Bis zu 9 zusätzliche Kategorien, jeweils ein { id?, name }. Ein reiner Name wird akzeptiert, und seine id wird aus dem Kategoriekatalog aufgelöst, sofern eine Übereinstimmung existiert. IDs selbst nachschlagen mit GET /api/v1/locations/categories.
idstringoptional
namestringoptional
descriptionstringoptional
Eine kurze Beschreibung des Unternehmens.
tagsarray of stringoptional
Interne Tags für Ihre eigene Organisation — nicht öffentlich sichtbar.
latitudenumberoptional
Breitengrad, in Dezimalgrad. Wird automatisch aus der Adresse abgeleitet, wenn weggelassen.
longitudenumberoptional
Längengrad, in Dezimalgrad. Wird automatisch aus der Adresse abgeleitet, wenn weggelassen.
customFieldsobjectoptional
Werte benutzerdefinierter Felder, die für diesen Standort gesetzt werden sollen, geschlüsselt nach Feld-ID.
serviceAreaobjectoptional
Einstellungen für das Einzugsgebiet im Master, für ein Unternehmen, das Kunden an deren Standort bedient. Setzen Sie businessType auf CUSTOMER_LOCATION_ONLY, um die Straßenadresse auszublenden: Kein Publisher erhält eine Straße, die er anzeigen würde, auch wenn eine gespeichert ist. Senden Sie null, um die Einstellung zu entfernen. Um es nur für einzelne Publisher festzulegen, verwenden Sie publisherServiceAreas oder applyToPublishers.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
namestringerforderlich
placeIdstringoptional
Google-Place-ID des Gebiets. Google akzeptiert nur Orte mit einer solchen ID, daher wird ein Ort ohne sie gespeichert, aber nicht an Google gesendet.
placeTypestring (country | administrativeArea | locality | postalCode)optional
publisherServiceAreasobjectoptional
Ein eigenes Einzugsgebiet für Google, Facebook, Apple oder Bing, jeweils in derselben Form wie serviceArea. Es wird als eigener Wert dieses Publishers gespeichert und in publisherOverrides zurückgegeben. Ein Publisher, den Sie weglassen, verwendet serviceArea.
googleobjectoptional
Einstellungen für das Einzugsgebiet im Master, für ein Unternehmen, das Kunden an deren Standort bedient. Setzen Sie businessType auf CUSTOMER_LOCATION_ONLY, um die Straßenadresse auszublenden: Kein Publisher erhält eine Straße, die er anzeigen würde, auch wenn eine gespeichert ist. Senden Sie null, um die Einstellung zu entfernen. Um es nur für einzelne Publisher festzulegen, verwenden Sie publisherServiceAreas oder applyToPublishers.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
namestringerforderlich
placeIdstringoptional
Google-Place-ID des Gebiets. Google akzeptiert nur Orte mit einer solchen ID, daher wird ein Ort ohne sie gespeichert, aber nicht an Google gesendet.
placeTypestring (country | administrativeArea | locality | postalCode)optional
facebookobjectoptional
Einstellungen für das Einzugsgebiet im Master, für ein Unternehmen, das Kunden an deren Standort bedient. Setzen Sie businessType auf CUSTOMER_LOCATION_ONLY, um die Straßenadresse auszublenden: Kein Publisher erhält eine Straße, die er anzeigen würde, auch wenn eine gespeichert ist. Senden Sie null, um die Einstellung zu entfernen. Um es nur für einzelne Publisher festzulegen, verwenden Sie publisherServiceAreas oder applyToPublishers.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
namestringerforderlich
placeIdstringoptional
Google-Place-ID des Gebiets. Google akzeptiert nur Orte mit einer solchen ID, daher wird ein Ort ohne sie gespeichert, aber nicht an Google gesendet.
placeTypestring (country | administrativeArea | locality | postalCode)optional
appleobjectoptional
Einstellungen für das Einzugsgebiet im Master, für ein Unternehmen, das Kunden an deren Standort bedient. Setzen Sie businessType auf CUSTOMER_LOCATION_ONLY, um die Straßenadresse auszublenden: Kein Publisher erhält eine Straße, die er anzeigen würde, auch wenn eine gespeichert ist. Senden Sie null, um die Einstellung zu entfernen. Um es nur für einzelne Publisher festzulegen, verwenden Sie publisherServiceAreas oder applyToPublishers.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
namestringerforderlich
placeIdstringoptional
Google-Place-ID des Gebiets. Google akzeptiert nur Orte mit einer solchen ID, daher wird ein Ort ohne sie gespeichert, aber nicht an Google gesendet.
placeTypestring (country | administrativeArea | locality | postalCode)optional
bingobjectoptional
Einstellungen für das Einzugsgebiet im Master, für ein Unternehmen, das Kunden an deren Standort bedient. Setzen Sie businessType auf CUSTOMER_LOCATION_ONLY, um die Straßenadresse auszublenden: Kein Publisher erhält eine Straße, die er anzeigen würde, auch wenn eine gespeichert ist. Senden Sie null, um die Einstellung zu entfernen. Um es nur für einzelne Publisher festzulegen, verwenden Sie publisherServiceAreas oder applyToPublishers.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
namestringerforderlich
placeIdstringoptional
Google-Place-ID des Gebiets. Google akzeptiert nur Orte mit einer solchen ID, daher wird ein Ort ohne sie gespeichert, aber nicht an Google gesendet.
placeTypestring (country | administrativeArea | locality | postalCode)optional
socialLinksobjectoptional
URLs von Social-Media-Profilen: facebook, instagram, twitter, linkedin, youtube, tiktok, pinterest. Beim Aktualisieren ändern sich nur die gesendeten Schlüssel; null entfernt einen. Wird bei Google als dessen url_*-Attribute sowie an Bing und Apple veröffentlicht.
facebookstringoptional
instagramstringoptional
twitterstringoptional
linkedinstringoptional
youtubestringoptional
tiktokstringoptional
pintereststringoptional
paymentMethodsarray of stringoptional
Akzeptierte Zahlungsarten, z. B. „Visa", „American Express", „Cash only". Ersetzt die gesamte Liste; eine leere Liste oder null entfernt sie. Wird bei Google als dessen pay_*-Attribute sowie an Apple und Bing veröffentlicht.
Antwort
dataobjectoptional
locationIdstringoptional
ID des neu erstellten Standorts.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/locations
Ihr API-Schlüssel
Anfragetext*
{
"data": {
"locationId": "loc_456"
}
}Anleitungen, die diesen Endpunkt verwenden
- What Is a Business Listings API?A business listings API manages a business's name, address, hours and more across many publishers at once, with sync status and duplicate detection built in.
- Business Listings API: Complete Developer GuideHow a business listings API works and how to create, update, sync and monitor locations across Google, Apple, Bing and directories with the Synup API.
- Create a Location with the Synup APICreate a business location in one POST, with or without a client, get back a locationId, and know which fields matter and which can wait.
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Manage Thousands of Business Locations via APIDesign a sync job for thousands of locations on the Synup API with cursor pagination, tags, rate-limit handling, an id map and rollup health checks.
- How to Add Local Marketing Functionality to Vertical SaaSAdd local marketing to a vertical SaaS by mapping existing customers to clients and locations, and shipping only the features your niche needs.