Skip to main content
Reviews is the primitive for reputation analysis across major review ecosystems. Use it to monitor customer sentiment, compare competitors, track rating changes, and correlate review trends with social engagement.
Reviews is a use-case view over Business Data — there is no separate /v1/reviews route. Every call below maps to a /v1/business/... endpoint (Google/Trustpilot/TripAdvisor reviews + social engagement). There is no dedicated SDK sub-client; use the CLI (naive business ...) or the Business Data REST/MCP surface.

​
CLI First

# Google business profile + review summary (live)
naive business google my-business-info --keyword "pizza new york" --location-code 1023191

# Trustpilot reviews (async)
naive business trustpilot reviews --domain "example.com"

# TripAdvisor reviews (async)
naive business tripadvisor reviews --url-path "Restaurant_Review-g60763-d12345-..."

# Social engagement metrics (live)
naive business social facebook --targets "https://example.com,https://blog.example.com"

​
Endpoints

PlatformEndpointDescriptionSpeedCost
Google My Businessmy-business-infoBusiness profile details + rating contextLive2 credits
Google ReviewsreviewsBusiness review text and ratingsStandard (async)2 credits
Google Q&Aquestions-and-answersBusiness profile Q&A contentLive2 credits
TrustpilotsearchDiscover businesses on TrustpilotStandard (async)2 credits
TrustpilotreviewsRetrieve domain reviewsStandard (async)2 credits
TripAdvisorreviewsRetrieve listing reviewsStandard (async)2 credits
Social Mediafacebook / pinterest / redditURL-level engagement metricsLive1 credit

​
Google Reputation Endpoints

EndpointRouteMethod
my-business-infoPOST /v1/business/google/my-business-infoLive
reviewsPOST /v1/business/google/reviews/taskStandard (async)
questions-and-answersPOST /v1/business/google/questions-and-answersLive

​
Parameters

ParamTypeRequiredDefaultDescription
keywordstringYes—Business query/name
location_codenumberNo—Location code
language_codestringNo—Language code
depthnumberNo100Review depth (reviews)
sort_bystringNomost_relevantSort mode (reviews)

​
Trustpilot + TripAdvisor (Async)

Both providers use submit/check/retrieve task flow:
  1. Submit POST /v1/business/{platform}/{endpoint}/task
  2. Check GET /v1/business/{platform}/{endpoint}/tasks-ready
  3. Retrieve GET /v1/business/{platform}/{endpoint}/task/:id
# Trustpilot reviews
curl -X POST https://api.usenaive.ai/v1/business/trustpilot/reviews/task \
  -H "Authorization: Bearer nv_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "example.com" }'

# TripAdvisor reviews
curl -X POST https://api.usenaive.ai/v1/business/tripadvisor/reviews/task \
  -H "Authorization: Bearer nv_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "url_path": "Restaurant_Review-g60763-d12345-..." }'

​
Social Engagement Endpoints (Live)

PlatformRoutePurpose
FacebookPOST /v1/business/social/facebookLikes, shares, comments for target URLs
PinterestPOST /v1/business/social/pinterestPin counts for target URLs
RedditPOST /v1/business/social/redditSubmission metrics for target URLs
Request body for all platforms: 
{
  "targets": ["https://example.com", "https://blog.example.com"]
}

​
Typical Workflow

Agent receives task: "Audit our online reputation"
    │
    ├─ POST /v1/business/google/my-business-info
    │   { keyword: "brand name city" }
    │   → Ratings baseline and business profile
    │
    ├─ POST /v1/business/google/reviews/task
    │   { keyword: "brand name city" }
    │   → Google review task ID
    │
    ├─ POST /v1/business/trustpilot/reviews/task
    │   { domain: "brand.com" }
    │   → Trustpilot task ID
    │
    ├─ POST /v1/business/tripadvisor/reviews/task
    │   { url_path: "Restaurant_Review-..." }
    │   → TripAdvisor task ID
    │
    └─ POST /v1/business/social/facebook
        { targets: ["https://brand.com"] }
        → Engagement context alongside reviews