GETapi.synup.com/api/v4/locations-by-ids
List particular locations
This API retrieves detailed information for one or more specified location IDs.
It provides comprehensive data about each location, including its name, address, contact details, business hours, categories, nedia and other relevant attributes. It support for both active and archived locations.
Requires an API key. Send it as
Authorization: API <your-key> — see Getting started.Parameters
Query
| Name | Type | Required | Description |
|---|---|---|---|
ids | array | required | Array of location IDs in JSON string format. |
Request
Request
curl -X GET 'https://api.synup.com/api/v4/locations-by-ids?ids=' \
-H 'Authorization: API YOUR_API_KEY' \
-H 'Content-Type: application/json'const res = await fetch('https://api.synup.com/api/v4/locations-by-ids?ids=', {
method: 'GET',
headers: {
Authorization: 'API YOUR_API_KEY',
'Content-Type': 'application/json',
},
});
const data = await res.json();import requests
res = requests.get(
"https://api.synup.com/api/v4/locations-by-ids?ids=",
headers={
"Authorization": "API YOUR_API_KEY",
"Content-Type": "application/json",
},
)
data = res.json()req, _ := http.NewRequest("GET", "https://api.synup.com/api/v4/locations-by-ids?ids=", nil)
req.Header.Set("Authorization", "API YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)Responses
| Status | Description |
|---|---|
200 | |
400 | Bad request - Invalid location IDs format |
401 | Unauthorized - Invalid or missing API key |
404 | One or more location IDs not found |
Example response
{
"data": {
"getLocationsByIds": [
{
"accountId": 11073,
"addOns": [
{
"id": "1",
"name": "Yelp Lite"
}
],
"additionalCategoryIds": [
609
],
"additionalCategoryNames": [
"Framing"
],
"additionalInfo": null,
"additionalPhones": [
"6036610058"
],
"approved": "APPROVED",
"archivalScheduledAt": null,
"archived": false,
"archivedAt": null,
"bizUrl": "www.easports222.com",
"bizUrlUtm": false,
"bookingUrl": null,
"businessHours": [
{
"day": "SUNDAY",
"slots": null,
"specialDate": null,
"type": "CLOSED"
},
{
"day": "MONDAY",
"slots": [
{
"end": "05:00pm",
"start": "09:00am"
}
],
"specialDate": null,
"type": "OPEN"
},
{
"day": "TUESDAY",
"slots": [
{
"end": "01:00pm",
"start": "09:00am"
},
{
"end": "05:00pm",
"start": "02:00pm"
}
],
"specialDate": null,
"type": "OPEN"
},
{
"day": "WEDNESDAY",
"slots": null,
"specialDate": null,
"type": "OPEN_24x7"
},
{
"day": "THURSDAY",
"slots": null,
"specialDate": null,
"type": "OPEN_24x7"
},
{
"day": "FRIDAY",
"slots": null,
"specialDate": null,
"type": "CLOSED"
},
{
"day": "SATURDAY",
"slots": null,
"specialDate": null,
"type": "CLOSED"
}
],
"cancellationScheduledAt": null,
"categoryId": 1,
"city": "New York",
"contentPreferredLanguage": "ENGLISH",
"countryCode": "1",
"countryIso": "US",
"createErrors": [],
"createdDate": "December 15, 2025",
"customAttributes": [
{
"archived": false,
"enumValues": [],
"name": "Atributo",
"slug": "atributo",
"type": "STRING",
"value": []
},
{
"archived": false,
"enumValues": [],
"name": "offers_online_appointments",
"slug": "offers_online_appointments",
"type": "BOOLEAN",
"value": [
"false"
]
},
{
"archived": false,
"enumValues": [],
"name": "welcomes_lgbtq",
"slug": "welcomes_lgbtq",
"type": "BOOLEAN",
"value": [
"true"
]
},
{
"archived": false,
"enumValues": [],
"name": "has wheelchair",
"slug": "has_wheelchair",
"type": "BOOLEAN",
"value": []
},
{
"archived": false,
"enumValues": [],
"name": "utm",
"slug": "utm",
"type": "STRING",
"value": []
},
{
"archived": false,
"enumValues": [],
"name": "Slug",
"slug": "slug",
"type": "STRING",
"value": []
},
{
"archived": false,
"enumValues": [],
"name": "Name",
"slug": "name",
"type": "STRING",
"value": []
},
{
"archived": false,
"enumValues": [],
"name": "accept digital rupee",
"slug": "accept_digital_rupee",
"type": "INTEGER",
"value": []
},
{
"archived": false,
"enumValues": [],
"name": "has_onsite_parking",
"slug": "has_onsite_parking",
"type": "BOOLEAN",
"value": []
},
{
"archived": false,
"enumValues": [],
"name": "Test 23",
"slug": "test_23",
"type": "STRING",
"value": []
},
{
"archived": false,
"enumValues": [],
"name": "lead_photo_drive",
"slug": "lead_photo_drive",
"type": "STRING",
"value": []
},
{
"archived": false,
"enumValues": [],
"name": "Test French Locale 4",
"slug": "test_french_locale_4",
"type": "STRING",
"value": []
}
],
"databaseId": 88350,
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor. This is a sample description which is used to complete the 200 characters. Let us believe this has exceeded the character limit otherwise it is going to be a headache to go and change it again. But still to be on the careful side, I am adding a few more line of characters because of which this is going to work.",
"enabledSiteIds": [],
"facebookUrl": "https://www.facebook.com/journeywithanthony/",
"folderId": "57e34303-e9fd-422d-ad39-383849df7ea9",
"folderName": "hello12341",
"franchise": null,
"googleAdsPhone": "8289989989",
"googleVerificationStatus": {
"message": null,
"status": null
},
"googleplusUrl": null,
"hideAddress": false,
"id": "TG9jYXRpb246ODgzNTA=",
"instagramUrl": "https://www.instagram.com/rajinikanth/",
"isRestaurant": false,
"lastUpdatedDate": "December 15, 2025",
"latitude": "40.712775",
"linkedinUrl": "https://www.linkedin.com/company/synup/",
"locationPhotos": [],
"longitude": "-74.005973",
"managedServiceSiteBuckets": [],
"managedServiceSites": [],
"moreHours": [],
"name": "Spinka Group",
"offeringsUrl": null,
"ownerEmail": "pttqa1+212@gmail.com",
"ownerName": "John Doe",
"package": "PREMIUM",
"paymentMethods": [
"VISA",
"MASTERCARD",
"AMEX",
"CASH",
"CHEQUE",
"CRYPTO",
"DINERS_CLUB",
"DISCOVER",
"FINANCING",
"INVOICE",
"TRAVELERS_CHECK",
"APPLE_PAY",
"SAMSUNG_PAY",
"PAYPAL",
"ANDROID_PAY"
],
"phone": "6036610058",
"pinterestUrl": "https://pinterest.com/cozylivin77/",
"planId": 59,
"planName": null,
"postalCode": "60605",
"publisherAttributes": [],
"reservationUrl": null,
"serviceItems": [],
"stateIso": "NY",
"stateName": "New York",
"storeId": "995si",
"street": "123 Jump Street",
"street1": null,
"subCategoryId": 20,
"subCategoryName": "Pilates",
"tagline": "We Exist",
"tags": [
"all",
"pk"
],
"temporarilyClosed": false,
"tiktokUrl": null,
"toplineMessage": null,
"toplineMessageText": null,
"twitterUrl": "https://twitter.com/elonmusk",
"uid": "0afc0561-04e0-4e72-b679-318310c1a8f1",
"updatedAt": "2025-12-15T10:06:47.776Z",
"videos": [
"https://www.youtube.com/watch?v=QKmrDUJFRkM"
],
"voiceStatus": 1,
"yearOfIncorporation": 1179,
"youtubeUrl": null,
"placeActionLinks": [
{
"placeActionType": "FOOD_ORDERING",
"uri": "https://order.example.com",
"isPreferred": true,
"name": "locations/1944.../placeActionLinks/54ada85bc246058a",
"submissionStatus": "success",
"submissionMessage": "Already up to date on Google.",
"lastSubmittedAt": "2026-07-08T12:14:36Z"
}
],
"discoveredPlaceActionLinks": [
{
"placeActionType": "APPOINTMENT",
"uri": "https://book.example.com",
"isPreferred": false,
"name": "locations/1944.../placeActionLinks/abc123",
"providerType": "MERCHANT",
"isEditable": true
}
]
}
]
}
}Response body
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | |
data.getLocationsByIds | array of object | required | |
data.getLocationsByIds[].accountId | integer | optional | |
data.getLocationsByIds[].addOns | array of object | optional | |
data.getLocationsByIds[].addOns[].id | string | optional | |
data.getLocationsByIds[].addOns[].name | string | optional | |
data.getLocationsByIds[].additionalCategoryIds | array of integer | optional | |
data.getLocationsByIds[].additionalCategoryNames | array of string | optional | |
data.getLocationsByIds[].additionalInfo | null | optional | |
data.getLocationsByIds[].additionalPhones | array of string | optional | |
data.getLocationsByIds[].approved | string | optional | |
data.getLocationsByIds[].archivalScheduledAt | null | optional | |
data.getLocationsByIds[].archived | boolean | optional | |
data.getLocationsByIds[].archivedAt | null | optional | |
data.getLocationsByIds[].bizUrl | string | optional | |
data.getLocationsByIds[].bizUrlUtm | boolean | optional | |
data.getLocationsByIds[].bookingUrl | null | optional | |
data.getLocationsByIds[].businessHours | array of object | optional | |
data.getLocationsByIds[].businessHours[].day | string | required | |
data.getLocationsByIds[].businessHours[].slots | array of object | required | |
data.getLocationsByIds[].businessHours[].slots[].end | string | required | |
data.getLocationsByIds[].businessHours[].slots[].start | string | required | |
data.getLocationsByIds[].businessHours[].specialDate | null | required | |
data.getLocationsByIds[].businessHours[].type | string | required | |
data.getLocationsByIds[].cancellationScheduledAt | null | optional | |
data.getLocationsByIds[].categoryId | integer | optional | |
data.getLocationsByIds[].city | string | optional | |
data.getLocationsByIds[].contentPreferredLanguage | string | optional | |
data.getLocationsByIds[].countryCode | string | optional | |
data.getLocationsByIds[].countryIso | string | optional | |
data.getLocationsByIds[].createErrors | array of string | optional | |
data.getLocationsByIds[].createdDate | string | optional | |
data.getLocationsByIds[].customAttributes | array of object | optional | |
data.getLocationsByIds[].customAttributes[].archived | boolean | required | |
data.getLocationsByIds[].customAttributes[].enumValues | array of string | required | |
data.getLocationsByIds[].customAttributes[].name | string | required | |
data.getLocationsByIds[].customAttributes[].slug | string | required | |
data.getLocationsByIds[].customAttributes[].type | string | required | |
data.getLocationsByIds[].customAttributes[].value | array of string | required | |
data.getLocationsByIds[].databaseId | integer | optional | |
data.getLocationsByIds[].description | string | optional | |
data.getLocationsByIds[].enabledSiteIds | array of string | optional | |
data.getLocationsByIds[].facebookUrl | string | optional | |
data.getLocationsByIds[].folderId | string | optional | |
data.getLocationsByIds[].folderName | string | optional | |
data.getLocationsByIds[].franchise | null | optional | |
data.getLocationsByIds[].googleAdsPhone | string | optional | |
data.getLocationsByIds[].googleVerificationStatus | object | optional | |
data.getLocationsByIds[].googleVerificationStatus.message | null | required | |
data.getLocationsByIds[].googleVerificationStatus.status | null | required | |
data.getLocationsByIds[].googleplusUrl | null | optional | |
data.getLocationsByIds[].hideAddress | boolean | optional | |
data.getLocationsByIds[].id | string | optional | |
data.getLocationsByIds[].instagramUrl | string | optional | |
data.getLocationsByIds[].isRestaurant | boolean | optional | |
data.getLocationsByIds[].lastUpdatedDate | string | optional | |
data.getLocationsByIds[].latitude | string | optional | |
data.getLocationsByIds[].linkedinUrl | string | optional | |
data.getLocationsByIds[].locationPhotos | array of string | optional | |
data.getLocationsByIds[].longitude | string | optional | |
data.getLocationsByIds[].managedServiceSiteBuckets | array of string | optional | |
data.getLocationsByIds[].managedServiceSites | array of string | optional | |
data.getLocationsByIds[].moreHours | array of string | optional | |
data.getLocationsByIds[].name | string | optional | |
data.getLocationsByIds[].offeringsUrl | null | optional | |
data.getLocationsByIds[].ownerEmail | string | optional | |
data.getLocationsByIds[].ownerName | string | optional | |
data.getLocationsByIds[].package | string | optional | |
data.getLocationsByIds[].paymentMethods | array of string | optional | |
data.getLocationsByIds[].phone | string | optional | |
data.getLocationsByIds[].pinterestUrl | string | optional | |
data.getLocationsByIds[].planId | integer | optional | |
data.getLocationsByIds[].planName | null | optional | |
data.getLocationsByIds[].postalCode | string | optional | |
data.getLocationsByIds[].publisherAttributes | array of string | optional | |
data.getLocationsByIds[].reservationUrl | null | optional | |
data.getLocationsByIds[].serviceItems | array of string | optional | |
data.getLocationsByIds[].stateIso | string | optional | |
data.getLocationsByIds[].stateName | string | optional | |
data.getLocationsByIds[].storeId | string | optional | |
data.getLocationsByIds[].street | string | optional | |
data.getLocationsByIds[].street1 | null | optional | |
data.getLocationsByIds[].subCategoryId | integer | optional | |
data.getLocationsByIds[].subCategoryName | string | optional | |
data.getLocationsByIds[].tagline | string | optional | |
data.getLocationsByIds[].tags | array of string | optional | |
data.getLocationsByIds[].temporarilyClosed | boolean | optional | |
data.getLocationsByIds[].tiktokUrl | null | optional | |
data.getLocationsByIds[].toplineMessage | null | optional | |
data.getLocationsByIds[].toplineMessageText | null | optional | |
data.getLocationsByIds[].twitterUrl | string | optional | |
data.getLocationsByIds[].uid | string | optional | |
data.getLocationsByIds[].updatedAt | string | optional | |
data.getLocationsByIds[].videos | array of string | optional | |
data.getLocationsByIds[].voiceStatus | integer | optional | |
data.getLocationsByIds[].yearOfIncorporation | integer | optional | |
data.getLocationsByIds[].youtubeUrl | null | optional | |
data.getLocationsByIds[].placeActionLinks | array of object | optional | |
data.getLocationsByIds[].placeActionLinks[].placeActionType | string | required | |
data.getLocationsByIds[].placeActionLinks[].uri | string | required | |
data.getLocationsByIds[].placeActionLinks[].isPreferred | boolean | optional | |
data.getLocationsByIds[].placeActionLinks[].name | string | optional | |
data.getLocationsByIds[].placeActionLinks[].submissionStatus | string | optional | |
data.getLocationsByIds[].placeActionLinks[].submissionMessage | string | optional | |
data.getLocationsByIds[].placeActionLinks[].lastSubmittedAt | string | optional | |
data.getLocationsByIds[].discoveredPlaceActionLinks | array of object | optional | |
data.getLocationsByIds[].discoveredPlaceActionLinks[].placeActionType | string | required | |
data.getLocationsByIds[].discoveredPlaceActionLinks[].uri | string | required | |
data.getLocationsByIds[].discoveredPlaceActionLinks[].isPreferred | string | required | |
data.getLocationsByIds[].discoveredPlaceActionLinks[].name | string | required | |
data.getLocationsByIds[].discoveredPlaceActionLinks[].providerType | string | required | |
data.getLocationsByIds[].discoveredPlaceActionLinks[].isEditable | string | required |