GETapi.synup.com/api/v4/locations/{locationId}/ai-listings
Get AI listings
This API retrieves all premium listings associated with a specific location.
Response Includes: Business Advice , Visibility Score and Sites Results
Requires an API key. Send it as
Authorization: API <your-key> — see Getting started.Parameters
Path
| Name | Type | Required | Description |
|---|---|---|---|
locationId | string | required | ID of the location in base-64 enconded format |
Headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type | string | required | Example: application/json |
Request
Request
curl -X GET 'https://api.synup.com/api/v4/locations/:locationId/ai-listings' \
-H 'Authorization: API YOUR_API_KEY' \
-H 'Content-Type: application/json'const res = await fetch('https://api.synup.com/api/v4/locations/:locationId/ai-listings', {
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/:locationId/ai-listings",
headers={
"Authorization": "API YOUR_API_KEY",
"Content-Type": "application/json",
},
)
data = res.json()req, _ := http.NewRequest("GET", "https://api.synup.com/api/v4/locations/:locationId/ai-listings", 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 |
Example response
{
"data": {
"fetchAiListings": {
"aiBusinessAdvice": {
"footer": "By focusing on these locally inspired tips, you can enhance your business's appeal and attract more customers in Winter Park.",
"header": "Winter Park is a popular destination known for its stunning mountain views, outdoor recreational activities, and vibrant local culture. Based on the local trends and traditions, here are some suggestions to improve your bicycle rental business:",
"tips": [
"Local Partnerships :: Collaborate with nearby hotels and resorts to offer exclusive rental deals.",
"Trail Maps :: Provide detailed maps of popular biking trails and scenic routes.",
"Guided Tours :: Offer guided bike tours showcasing local landmarks and hidden gems.",
"Seasonal Events :: Host biking events or races during peak tourist seasons.",
"Loyalty Programs :: Implement a rewards program for repeat customers and referrals.",
"Social Media Presence :: Share customer stories and local biking highlights on social platforms.",
"Merchandise Sales :: Sell branded gear and souvenirs to enhance the customer experience.",
"Maintenance Workshops :: Offer bike maintenance workshops to attract biking enthusiasts.",
"Eco-Friendly Options :: Introduce eco-friendly bike options and promote sustainable practices.",
"Community Engagement :: Participate in local festivals and sponsor community events."
],
"__typename": "AiBusinessAdvice"
},
"aiVisibilityScore": 40,
"aiSitesResults": [
{
"siteUrl": "openai.com",
"liveLink": "https://ai-listing-chatgpt.vercel.app/listing/4140924",
"aiScore": {
"addressSimilarity": 0.7952201644509336,
"phoneSimilarity": 1,
"overallSimilarity": 0.5,
"websiteSimilarity": 1,
"__typename": "AiListingsScore"
},
"aiResponse": {
"name": "Christy Sports",
"address": "78902 US-40, Winter Park, CO 80482, USA",
"website": "https://www.christysports.com",
"phone": "+1 970-726-8873",
"__typename": "AiListingsResponse"
},
"customerPrompt": "What is the Address, Phone Number, Business Website, Opening Hours of Christy Sports located in Winter Park as of today.",
"__typename": "AiListingsData"
},
{
"siteUrl": "gemini.google.com",
"liveLink": "https://ai-listing-gemini.vercel.app/listing/4141628",
"aiScore": {
"addressSimilarity": 0.7952201644509336,
"phoneSimilarity": 1,
"overallSimilarity": 0.5,
"websiteSimilarity": 1,
"__typename": "AiListingsScore"
},
"aiResponse": {
"name": "Christy Sports",
"address": "78902 US-40, Winter Park, CO 80482, USA",
"website": "https://www.christysports.com",
"phone": "+1 970-726-8873",
"__typename": "AiListingsResponse"
},
"customerPrompt": "What is the Address, Phone Number, Business Website, Opening Hours of Christy Sports located in Winter Park as of today.",
"__typename": "AiListingsData"
},
{
"siteUrl": "perplexity.ai",
"liveLink": null,
"aiScore": {
"addressSimilarity": 0.7952201644509336,
"phoneSimilarity": 1,
"overallSimilarity": 0,
"websiteSimilarity": 1,
"__typename": "AiListingsScore"
},
"aiResponse": {
"name": "Christy Sports",
"address": "78902 US-40, Winter Park, CO 80482, USA",
"website": "https://www.christysports.com",
"phone": "+1 970-726-8873",
"__typename": "AiListingsResponse"
},
"customerPrompt": "What is the Address, Phone Number, Business Website, Opening Hours of Christy Sports located in Winter Park as of today.",
"__typename": "AiListingsData"
},
{
"siteUrl": "copilot.microsoft.com",
"liveLink": null,
"aiScore": {
"addressSimilarity": 0.7952201644509336,
"phoneSimilarity": 1,
"overallSimilarity": 0,
"websiteSimilarity": 1,
"__typename": "AiListingsScore"
},
"aiResponse": {
"name": "Christy Sports",
"address": "78902 US-40, Winter Park, CO 80482, USA",
"website": "https://www.christysports.com",
"phone": "+1 970-726-8873",
"__typename": "AiListingsResponse"
},
"customerPrompt": "What is the Address, Phone Number, Business Website, Opening Hours of Christy Sports located in Winter Park as of today.",
"__typename": "AiListingsData"
},
{
"siteUrl": "intellychat.com",
"liveLink": "https://ai-listing-intellychat.vercel.app/listing/4141631",
"aiScore": {
"addressSimilarity": 0.7952201644509336,
"phoneSimilarity": 1,
"overallSimilarity": 0,
"websiteSimilarity": 1,
"__typename": "AiListingsScore"
},
"aiResponse": {
"name": "Christy Sports",
"address": "78902 US-40, Winter Park, CO 80482, USA",
"website": "https://www.christysports.com",
"phone": "+1 970-726-8873",
"__typename": "AiListingsResponse"
},
"customerPrompt": "What is the Address, Phone Number, Business Website, Opening Hours of Christy Sports located in Winter Park as of today.",
"__typename": "AiListingsData"
},
{
"siteUrl": "myndmeld.com",
"liveLink": "https://ai-listing-myndmeld.vercel.app/listing/4141630",
"aiScore": {
"addressSimilarity": 0.7952201644509336,
"phoneSimilarity": 1,
"overallSimilarity": 0.5,
"websiteSimilarity": 1,
"__typename": "AiListingsScore"
},
"aiResponse": {
"name": "Christy Sports",
"address": "78902 US-40, Winter Park, CO 80482, USA",
"website": "https://www.christysports.com",
"phone": "+1 970-726-8873",
"__typename": "AiListingsResponse"
},
"customerPrompt": "What is the Address, Phone Number, Business Website, Opening Hours of Christy Sports located in Winter Park as of today.",
"__typename": "AiListingsData"
}
],
"__typename": "AiListings"
}
}
}Response body
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | |
data.fetchAiListings | object | required | |
data.fetchAiListings.aiBusinessAdvice | object | required | |
data.fetchAiListings.aiBusinessAdvice.footer | string | required | |
data.fetchAiListings.aiBusinessAdvice.header | string | required | |
data.fetchAiListings.aiBusinessAdvice.tips | array of string | required | |
data.fetchAiListings.aiBusinessAdvice.__typename | string | required | |
data.fetchAiListings.aiVisibilityScore | integer | required | |
data.fetchAiListings.aiSitesResults | array of object | required | |
data.fetchAiListings.aiSitesResults[].siteUrl | string | required | |
data.fetchAiListings.aiSitesResults[].liveLink | string | required | |
data.fetchAiListings.aiSitesResults[].aiScore | object | required | |
data.fetchAiListings.aiSitesResults[].aiScore.addressSimilarity | number | required | |
data.fetchAiListings.aiSitesResults[].aiScore.phoneSimilarity | integer | required | |
data.fetchAiListings.aiSitesResults[].aiScore.overallSimilarity | number | required | |
data.fetchAiListings.aiSitesResults[].aiScore.websiteSimilarity | integer | required | |
data.fetchAiListings.aiSitesResults[].aiResponse | object | required | |
data.fetchAiListings.aiSitesResults[].aiResponse.name | string | required | |
data.fetchAiListings.aiSitesResults[].aiResponse.address | string | required | |
data.fetchAiListings.aiSitesResults[].aiResponse.website | string | required | |
data.fetchAiListings.aiSitesResults[].aiResponse.phone | string | required | |
data.fetchAiListings.aiSitesResults[].customerPrompt | string | required |