Skip to content
SynupAPI
Get an API key
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

NameTypeRequiredDescription
locationIdstringrequiredID of the location in base-64 enconded format

Headers

NameTypeRequiredDescription
Content-TypestringrequiredExample: 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'

Responses

StatusDescription
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

NameTypeRequiredDescription
dataobjectrequired
data.fetchAiListingsobjectrequired
data.fetchAiListings.aiBusinessAdviceobjectrequired
data.fetchAiListings.aiBusinessAdvice.footerstringrequired
data.fetchAiListings.aiBusinessAdvice.headerstringrequired
data.fetchAiListings.aiBusinessAdvice.tipsarray of stringrequired
data.fetchAiListings.aiBusinessAdvice.__typenamestringrequired
data.fetchAiListings.aiVisibilityScoreintegerrequired
data.fetchAiListings.aiSitesResultsarray of objectrequired
data.fetchAiListings.aiSitesResults[].siteUrlstringrequired
data.fetchAiListings.aiSitesResults[].liveLinkstringrequired
data.fetchAiListings.aiSitesResults[].aiScoreobjectrequired
data.fetchAiListings.aiSitesResults[].aiScore.addressSimilaritynumberrequired
data.fetchAiListings.aiSitesResults[].aiScore.phoneSimilarityintegerrequired
data.fetchAiListings.aiSitesResults[].aiScore.overallSimilaritynumberrequired
data.fetchAiListings.aiSitesResults[].aiScore.websiteSimilarityintegerrequired
data.fetchAiListings.aiSitesResults[].aiResponseobjectrequired
data.fetchAiListings.aiSitesResults[].aiResponse.namestringrequired
data.fetchAiListings.aiSitesResults[].aiResponse.addressstringrequired
data.fetchAiListings.aiSitesResults[].aiResponse.websitestringrequired
data.fetchAiListings.aiSitesResults[].aiResponse.phonestringrequired
data.fetchAiListings.aiSitesResults[].customerPromptstringrequired