List reviews
curl --request GET \
--url https://api.aisa.one/apis/v1/social/inbox/reviews \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/social/inbox/reviews"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/social/inbox/reviews', 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.aisa.one/apis/v1/social/inbox/reviews",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/social/inbox/reviews"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/social/inbox/reviews")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/social/inbox/reviews")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"accountId": "<string>",
"accountUsername": "<string>",
"created": "2023-11-07T05:31:56Z",
"hasPhotos": true,
"hasReply": true,
"id": "<string>",
"locationId": "<string>",
"locationName": "<string>",
"photoCount": 123,
"photos": [
{
"url": "<string>"
}
],
"platform": "<string>",
"rating": 123,
"recommendationType": "positive",
"reply": {
"created": "2023-11-07T05:31:56Z",
"id": "<string>",
"text": "<string>"
},
"reviewUrl": "<string>",
"reviewer": {
"id": "<string>",
"name": "<string>",
"profileImage": "<string>"
},
"text": "<string>"
}
],
"meta": {
"accountsFailed": 123,
"accountsQueried": 123,
"accountsSkipped": [
{
"accountId": "<string>",
"platform": "<string>"
}
],
"failedAccounts": [
{
"accountId": "<string>",
"accountUsername": "<string>",
"code": "<string>",
"error": "<string>",
"platform": "<string>",
"retryAfter": 123
}
],
"lastUpdated": "2023-11-07T05:31:56Z"
},
"pagination": {
"hasMore": true,
"nextCursor": "<string>"
},
"status": "<string>",
"summary": {
"averageRating": 123,
"totalReviews": 123
}
}{
"error": {
"code": "<string>",
"details": {},
"message": "<string>",
"param": "<string>",
"retryHint": "never",
"retryable": true,
"type": "<string>"
}
}AIsa Social
List reviews
Reviews. Read only; needs social:read. Ids are yours: accounts acc_..., profiles prf_..., posts pst_...; every other object id is checked against your accounts before the call. Without profileId or accountId it reads your default profile.
Fetch reviews from all connected Facebook Pages and Google Business Profile accounts. Aggregates data with filtering and sorting options.
Supported platforms: Facebook, Google Business Profile.
Each account's reviews are read from the platform page by page within a 20-second budget per request, so very large accounts can come back truncated. Each account's listing is cached for up to 60 seconds.
<!-- aisa-pricing:start -->
A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->
GET
https://api.aisa.one
/
apis
/
v1
/
social
/
inbox
/
reviews
List reviews
curl --request GET \
--url https://api.aisa.one/apis/v1/social/inbox/reviews \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/social/inbox/reviews"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/social/inbox/reviews', 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.aisa.one/apis/v1/social/inbox/reviews",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/social/inbox/reviews"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/social/inbox/reviews")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/social/inbox/reviews")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"accountId": "<string>",
"accountUsername": "<string>",
"created": "2023-11-07T05:31:56Z",
"hasPhotos": true,
"hasReply": true,
"id": "<string>",
"locationId": "<string>",
"locationName": "<string>",
"photoCount": 123,
"photos": [
{
"url": "<string>"
}
],
"platform": "<string>",
"rating": 123,
"recommendationType": "positive",
"reply": {
"created": "2023-11-07T05:31:56Z",
"id": "<string>",
"text": "<string>"
},
"reviewUrl": "<string>",
"reviewer": {
"id": "<string>",
"name": "<string>",
"profileImage": "<string>"
},
"text": "<string>"
}
],
"meta": {
"accountsFailed": 123,
"accountsQueried": 123,
"accountsSkipped": [
{
"accountId": "<string>",
"platform": "<string>"
}
],
"failedAccounts": [
{
"accountId": "<string>",
"accountUsername": "<string>",
"code": "<string>",
"error": "<string>",
"platform": "<string>",
"retryAfter": 123
}
],
"lastUpdated": "2023-11-07T05:31:56Z"
},
"pagination": {
"hasMore": true,
"nextCursor": "<string>"
},
"status": "<string>",
"summary": {
"averageRating": 123,
"totalReviews": 123
}
}{
"error": {
"code": "<string>",
"details": {},
"message": "<string>",
"param": "<string>",
"retryHint": "never",
"retryable": true,
"type": "<string>"
}
}Request contract
- Method and path: GET /apis/v1/social/inbox/reviews
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/social/inbox/reviews - profileId: query; optional
- platform: query; optional
- minRating: query; optional
- maxRating: query; optional
- hasReply: query; optional
- sortBy: query; optional
- sortOrder: query; optional
- limit: query; optional
- cursor: query; optional
- accountId: query; optional
- Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
{
"operationId": "get_aisa_social_apis_v1_social_inbox_reviews",
"method": "GET",
"path": "/apis/v1/social/inbox/reviews",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"description": "One of your profiles (prf_...). Defaults to your default profile when neither profileId nor accountId is sent.",
"in": "query",
"name": "profileId",
"required": false,
"schema": {
"pattern": "^prf_[0-9A-Za-z]{22}$",
"type": "string"
}
},
{
"in": "query",
"name": "platform",
"required": false,
"schema": {
"enum": [
"facebook",
"googlebusiness"
],
"type": "string"
}
},
{
"in": "query",
"name": "minRating",
"required": false,
"schema": {
"maximum": 5,
"minimum": 1,
"type": "integer"
}
},
{
"in": "query",
"name": "maxRating",
"required": false,
"schema": {
"maximum": 5,
"minimum": 1,
"type": "integer"
}
},
{
"description": "Filter by reply status",
"in": "query",
"name": "hasReply",
"required": false,
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "sortBy",
"required": false,
"schema": {
"default": "date",
"enum": [
"date",
"rating"
],
"type": "string"
}
},
{
"in": "query",
"name": "sortOrder",
"required": false,
"schema": {
"default": "desc",
"enum": [
"asc",
"desc"
],
"type": "string"
}
},
{
"in": "query",
"name": "limit",
"required": false,
"schema": {
"default": 25,
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
{
"in": "query",
"name": "cursor",
"required": false,
"schema": {
"type": "string"
}
},
{
"description": "One of your social accounts (acc_...).",
"in": "query",
"name": "accountId",
"required": false,
"schema": {
"pattern": "^acc_[0-9A-Za-z]{22}$",
"type": "string"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"description": "Included with your connected social accounts: AIsa does not charge per call.",
"kind": "no_customer_charge"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
One of your profiles (prf_...). Defaults to your default profile when neither profileId nor accountId is sent.
Pattern:
^prf_[0-9A-Za-z]{22}$Available options:
facebook, googlebusiness Required range:
1 <= x <= 5Required range:
1 <= x <= 5Filter by reply status
Available options:
date, rating Available options:
asc, desc Required range:
1 <= x <= 50One of your social accounts (acc_...).
Pattern:
^acc_[0-9A-Za-z]{22}$