cURL
curl --request POST \
--url https://api.mindshare.so/customer/v1/get-recommendations \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"customerID": 123
}
'import requests
url = "https://api.mindshare.so/customer/v1/get-recommendations"
payload = { "customerID": 123 }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({customerID: 123})
};
fetch('https://api.mindshare.so/customer/v1/get-recommendations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mindshare.so/customer/v1/get-recommendations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'customerID' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mindshare.so/customer/v1/get-recommendations"
payload := strings.NewReader("{\n \"customerID\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mindshare.so/customer/v1/get-recommendations")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"customerID\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mindshare.so/customer/v1/get-recommendations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"customerID\": 123\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 123,
"title": "<string>",
"task": "<string>",
"data_points": "<string>",
"why_important": "<string>",
"platform": "<string>",
"status": "<string>",
"date": "2023-12-25",
"query_group_id": 123,
"take_action_url": "<string>",
"references": [
{
"source_id": 123,
"source_url": "<string>"
}
]
}
],
"version": "<string>",
"env": "<string>"
}Data Retrieval
Get Recommendations
Retrieve weekly strategic recommendations for improving brand visibility.
Our system provides data-driven recommendations that help you increase your presence in AI-generated responses. Each recommendation includes:
Why it’s relevant, platform where the recommendation should be executed (Reddit, blog, YouTube, etc.), references to third-party sources currently influencing AI engines, and a direct action URL when applicable.
Note: Google AI Overview is not yet supported here — at the moment all recommendations are generated based on ChatGPT visibility data only.
POST
/
get-recommendations
cURL
curl --request POST \
--url https://api.mindshare.so/customer/v1/get-recommendations \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"customerID": 123
}
'import requests
url = "https://api.mindshare.so/customer/v1/get-recommendations"
payload = { "customerID": 123 }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({customerID: 123})
};
fetch('https://api.mindshare.so/customer/v1/get-recommendations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mindshare.so/customer/v1/get-recommendations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'customerID' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mindshare.so/customer/v1/get-recommendations"
payload := strings.NewReader("{\n \"customerID\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mindshare.so/customer/v1/get-recommendations")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"customerID\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mindshare.so/customer/v1/get-recommendations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"customerID\": 123\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 123,
"title": "<string>",
"task": "<string>",
"data_points": "<string>",
"why_important": "<string>",
"platform": "<string>",
"status": "<string>",
"date": "2023-12-25",
"query_group_id": 123,
"take_action_url": "<string>",
"references": [
{
"source_id": 123,
"source_url": "<string>"
}
]
}
],
"version": "<string>",
"env": "<string>"
}AI Platforms
AI Platforms
Google AI Overview is not yet supported by this endpoint. At the moment all recommendations are generated based on ChatGPT visibility data only. Support for additional AI platforms may be added in the future.
Authorizations
Body
application/json
Customer ID
The ID of the customer