{ "openapi": "3.1.0", "info": { "title": "ReviewsData API", "version": "1.0.0", "description": "Real-Time Cross-Platform Customer & Employer Reviews, Star Ratings, 5-Star Histograms & Sentiment Polarity REST and MCP API covering Trustpilot, Yelp, TripAdvisor, Google Play Store, Apple App Store, and Glassdoor ($1 = 10,000 Credits · 2 Credits/review · $1.20 Free Trial).", "contact": { "name": "ReviewsData API Support", "email": "support@reviewsdataapi.com", "url": "https://reviewsdataapi.com" } }, "servers": [ { "url": "https://api.reviewsdataapi.com", "description": "Production Global Edge & Reputation Gateway" } ], "tags": [ { "name": "Trustpilot Reputation", "description": "Domain reviews, TrustScore, star distributions, AI summaries & verified reviewer badges." }, { "name": "Yelp Local Business", "description": "Local business search & full-length Yelp customer reviews without the 3-review Fusion cap." }, { "name": "TripAdvisor Hospitality", "description": "Destination geo_id discovery & ranked restaurant/hospitality reputation intelligence." }, { "name": "Mobile App Stores", "description": "Real-time Google Play Store & Apple App Store customer reviews, app versions & developer replies." }, { "name": "Glassdoor Employer Reputation", "description": "Employer company search, CEO approval, workplace sub-ratings & employee Pros/Cons reviews with sentiment polarity." } ], "paths": { "/v1/trustpilot/reviews": { "get": { "operationId": "v1_trustpilot_reviews", "tags": [ "Trustpilot Reputation" ], "summary": "Extract Trustpilot customer reviews, 5-star histogram & sentiment polarity", "description": "Returns verified Trustpilot customer reviews for any company domain with 5-star distribution histogram, aspect sentiment polarity tags (+Customer Support, -Billing UI, etc.), verification badges, reviewer history, and official company replies.", "x-price-per-request": "$0.0002 / review ($0.08–$0.20 / 1K reviews)", "x-credits-per-request": "2 Credits / review (0 Credits on empty)", "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "parameters": [ { "name": "domain", "in": "query", "required": true, "description": "Company domain on Trustpilot (e.g. printful.com, stripe.com, porkbun.com).", "example": "printful.com", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "1-based page index (20 reviews per page).", "example": 1, "schema": { "type": "integer", "default": 1, "minimum": 1 } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum reviews to return (1–50).", "example": 20, "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 50 } }, { "name": "fresh", "in": "query", "required": false, "description": "Bypass 15-minute warm cache for live pull (paid/subscribed accounts).", "example": false, "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Normalized cross-platform reputation, star distribution, and sentiment JSON payload.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1TrustpilotReviewsResponse" }, "example": { "code": 0, "provider": "https://reviewsdataapi.com", "status": "ok", "msg": "success", "data": { "platform": "trustpilot", "domain": "printful.com", "sentiment_summary": { "sampled_reviews": 20, "average_rating": 3.35, "star_distribution": { "1": 6, "2": 2, "3": 1, "4": 1, "5": 10 }, "star_percentages": { "1": 30, "2": 10, "3": 5, "4": 5, "5": 50 }, "sentiment_breakdown": { "positive_pct": 55, "neutral_pct": 5, "negative_pct": 40, "net_polarity_score": 0.2 }, "aspect_polarities": [ { "aspect": "Speed & Delivery", "polarity": "negative", "positive_pct": 20, "mentions": 5 }, { "aspect": "Customer Support", "polarity": "negative", "positive_pct": 40, "mentions": 5 } ] }, "reviews": [ { "review_id": "6af7acc1fd941bbb375cca9a", "platform": "trustpilot", "domain": "printful.com", "review_url": "https://www.trustpilot.com/reviews/6af7acc1fd941bbb375cca9a", "rating": 5, "title": "so easy to integrate", "review_text": "so easy to integrate", "verified": false, "verification_level": "BasicLink", "language": "en", "likes_count": 0, "published_at": "2026-11-14T02:35:13.000Z", "experienced_at": "2026-10-01T00:00:00.000Z", "sentiment": "positive", "polarity_score": 0.93, "author": { "id": "6a83542117a86039c7aa75e4", "name": "Enith Dali Morales Rios", "country_code": "US", "total_reviews": 2, "is_verified_reviewer": false, "avatar_url": null }, "company_reply": null }, { "review_id": "6af79a6aa0d2df3fa4d087e9", "platform": "trustpilot", "domain": "printful.com", "review_url": "https://www.trustpilot.com/reviews/6af79a6aa0d2df3fa4d087e9", "rating": 5, "title": "Very easy and simple to create my store.", "review_text": "Very easy and simple to create my store.", "verified": false, "verification_level": "BasicLink", "language": "en", "likes_count": 0, "published_at": "2026-11-14T01:16:58.000Z", "experienced_at": "2026-11-13T00:00:00.000Z", "sentiment": "positive", "polarity_score": 0.93, "author": { "id": "6af79a6474f74d31f6caa5c4", "name": "Katherine Elizabeth Jackson", "country_code": "US", "total_reviews": 1, "is_verified_reviewer": false, "avatar_url": "https://user-images.trustpilot.com/6af79a6474f74d31f6caa5c4/73x73.png" }, "company_reply": null } ], "pagination": { "page": 1, "per_page": 20, "total_reviews": 7453, "total_pages": 373, "has_more": true, "rating_distribution": { "1": 890, "2": 186, "3": 186, "4": 481, "5": 6255 } } }, "meta": { "request_id": "9989985f-997a-48e7-a66f-4e8231b0b8ea", "endpoint": "/v1/trustpilot/reviews", "items_returned": 20, "credits_charged": 40, "cached": false, "took_ms": 1256 } } } } }, "400": { "description": "Missing or invalid query parameter (0 credits charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid rv_live_ API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Insufficient credit balance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/trustpilot/company": { "get": { "operationId": "v1_trustpilot_company", "tags": [ "Trustpilot Reputation" ], "summary": "Fetch Trustpilot company TrustScore, star distribution, AI summary & verification", "description": "Retrieves a domain's canonical Trustpilot BusinessUnit profile including TrustScore, star rating, total reviews, 1–5 star distribution, AI review summary, negative-review reply rate, categories, and public contact info.", "x-price-per-request": "$0.001 / company profile ($0.40–$1.00 / 1K profiles)", "x-credits-per-request": "10 Credits / company profile", "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "parameters": [ { "name": "domain", "in": "query", "required": true, "description": "Target company domain (e.g. printful.com).", "example": "printful.com", "schema": { "type": "string" } }, { "name": "fresh", "in": "query", "required": false, "description": "Bypass 4-hour warm cache for live refresh.", "example": false, "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Normalized cross-platform reputation, star distribution, and sentiment JSON payload.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1TrustpilotCompanyResponse" }, "example": { "code": 0, "provider": "https://reviewsdataapi.com", "status": "ok", "msg": "success", "data": { "platform": "trustpilot", "company": { "company_id": "5aa7f1850c6df00001be09bc", "domain": "printful.com", "display_name": "Printful", "trust_score": 4.1, "stars": 4, "total_reviews": 7998, "is_claimed": true, "is_closed": false, "website_url": "https://www.printful.com/", "trustpilot_url": "https://www.trustpilot.com/review/printful.com", "logo_url": "https://s3-eu-west-1.amazonaws.com/tpd/logos/5aa7f1850c6df00001be09bc/0x0.png", "about": "We’re Printful, an on-demand printing and fulfillment company that helps people turn their ideas into brands and products. We fulfill and ship custom clothing, accessories, home & living items, or any of the 340+ products available in our catalog for online businesses and people worldwide.\n\nSelling custom products is one of the fastest ways to build a...", "ai_summary": { "summary_text": "Evaluating 897 reviews, reviewers had a great experience with this company. Consumers find the platform remarkably straightforward and intuitive to use, noting that setting up products and connecting online storefronts requires very little effort. Shoppers frequently mention that the physical items are exceptionally well-made, featuring vibrant prints and...", "summary_created_from_review_ids": null, "ai_summarized_reviews": [ { "review_id": "6ac4bc0a31975631f2c68bd2", "review_link": "https://www.trustpilot.com/reviews/6ac4bc0a31975631f2c68bd2", "title": "Mostly it works well", "text": "Mostly it works well, but there are some issues with synching featured images of products. Also group publishing runs into errors, like displaying all colors instead of only the ones you select.", "rating": 4, "language": "en", "is_verified": false, "is_pending": false, "source": "BasicLink", "published_at_date": "2026-10-06T11:14:50.000Z", "experience_date": "2026-10-06T00:00:00.000Z", "likes_count": 0, "company_reply": "We're glad it mostly works well. We hear you on image syncing and group publishing errors. Thank you for helping us improve🙏!", "company_reply_date": "2026-10-07T07:41:58.000Z", "reviewer": { "id": "67aa24a5bbb6ea2a5e34a8c4", "profile_link": "https://www.trustpilot.com/users/67aa24a5bbb6ea2a5e34a8c4", "name": "Valued Customer", "country_code": "US", "is_verified": false, "avatar_url": null, "total_reviews": 2, "reviews_on_this_company": 1 } }, { "review_id": "6ac53cfb13668e8b9cf0e859", "review_link": "https://www.trustpilot.com/reviews/6ac53cfb13668e8b9cf0e859", "title": "The platform is really easy to handle…", "text": "The platform is really easy to handle and has a wide range of products. I really like that.\nBut I have to say that the orders don't work well, I ordered something myself and didn't get it till yet :(", "rating": 4, "language": "en", "is_verified": false, "is_pending": false, "source": "BasicLink", "published_at_date": "2026-10-06T20:25:00.000Z", "experience_date": "2026-10-06T00:00:00.000Z", "likes_count": 0, "company_reply": "Thank you💚! We're glad you like the platform and product range. Sorry your own order hasn't arrived, please share your details so we can look into it: https://forms.gle/grBd4UvjvMhzADjWA", "company_reply_date": "2026-10-07T07:43:59.000Z", "reviewer": { "id": "6ac53cdfa9de7987bf2afb61", "profile_link": "https://www.trustpilot.com/users/6ac53cdfa9de7987bf2afb61", "name": "Vivian", "country_code": "AT", "is_verified": false, "avatar_url": null, "total_reviews": 1, "reviews_on_this_company": 1 } }, { "review_id": "6af08a49d744b2ae57b50f09", "review_link": "https://www.trustpilot.com/reviews/6af08a49d744b2ae57b50f09", "title": "Good customer support, but my language issue is still unresolved", "text": "My experience with Printful has been good overall. The customer support team has been friendly, professional, and helpful.\n\nHowever, I still have an unresolved issue with my Etsy store integration. My Etsy shop's default language is English (US), but Printful continues to display Spanish (ES) as the default publishing language, and the English (US) option...", "rating": 5, "language": "en", "is_verified": false, "is_pending": false, "source": "BasicLink", "published_at_date": "2026-11-08T16:42:17.000Z", "experience_date": "2026-11-08T00:00:00.000Z", "likes_count": 0, "company_reply": "Thank you for your feedback! We're glad our support team has been helpful. We're sorry the Etsy language setting issue is still unresolved; Our team will be happy to look into it. Please share details here: https://forms.gle/grBd4UvjvMhzADjWA", "company_reply_date": "2026-11-09T07:46:13.000Z", "reviewer": { "id": "6af08a3bd4299359afe94a4a", "profile_link": "https://www.trustpilot.com/users/6af08a3bd4299359afe94a4a", "name": "Abdelouahid El Mekaddam", "country_code": "ES", "is_verified": false, "avatar_url": "https://user-images.trustpilot.com/6af08a3bd4299359afe94a4a/73x73.png", "total_reviews": 1, "reviews_on_this_company": 1 } } ] }, "country_code": "US", "rating_distribution": { "1": 890, "2": 186, "3": 186, "4": 481, "5": 6255 }, "negative_reviews_reply_percent": 99.59677419354838, "average_days_to_reply": 0.15, "categories": [ { "id": "custom_t_shirt_store", "name": "", "is_primary": false }, { "id": "e-commerce_solution_provider", "name": "", "is_primary": false } ], "contact": { "email": "support@printful.com", "phone": null, "address": "11025 Westlake Dr, Charlotte, 28273, US", "city": "Charlotte", "zip_code": "28273", "country": "US" }, "verification": { "verified_payment_method": true, "verified_business": true } } }, "meta": { "request_id": "34ad7490-6016-4fb5-be89-678b6ce52d23", "endpoint": "/v1/trustpilot/company", "items_returned": 1, "credits_charged": 10, "cached": false, "took_ms": 1153 } } } } }, "400": { "description": "Missing or invalid query parameter (0 credits charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid rv_live_ API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Insufficient credit balance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/yelp/search": { "get": { "operationId": "v1_yelp_search", "tags": [ "Yelp Local Business" ], "summary": "Search Yelp local businesses by keyword and city/location", "description": "Searches Yelp local businesses by keyword and location with unrounded average ratings, total review counts, price tiers, categories, phone numbers, street addresses, and coordinates. Drop-in compatible with /v3/businesses/search.", "x-price-per-request": "$0.0005 / business ($0.20–$0.50 / 1K businesses)", "x-credits-per-request": "5 Credits / business (0 Credits on empty)", "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "parameters": [ { "name": "query", "in": "query", "required": true, "description": "Search keyword or category (e.g. coffee, sushi, dentist).", "example": "coffee", "schema": { "type": "string" } }, { "name": "location", "in": "query", "required": true, "description": "City, neighborhood, state, or postal address (e.g. Austin, TX).", "example": "Austin, TX", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum businesses to return (1–50).", "example": 20, "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 50 } } ], "responses": { "200": { "description": "Normalized cross-platform reputation, star distribution, and sentiment JSON payload.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1YelpSearchResponse" }, "example": { "code": 0, "provider": "https://reviewsdataapi.com", "status": "ok", "msg": "success", "data": { "platform": "yelp", "query": "coffee", "location": "Austin, TX", "total_estimated": 240, "businesses": [ { "business_id": "0wljsy6_0HIni0pooc5ozw", "alias": "mr-natural-austin", "name": "Mr Natural", "rating": 3.9, "review_count": 535, "price_level": "$$", "is_closed": false, "phone": "(512) 477-5228", "yelp_url": "https://www.yelp.com/biz/mr-natural-austin", "categories": [ { "alias": "vegetarian", "title": "Vegetarian" }, { "alias": "gluten_free", "title": "Gluten-Free" } ], "neighborhoods": [ "East Cesar Chavez", "East Austin" ], "address": { "line1": "1901 E Cesar Chavez St", "city": "Austin", "state": "TX", "postal_code": "78702", "country_code": "US", "formatted": "1901 E Cesar Chavez St, Austin, TX 78702" }, "coordinates": { "latitude": 30.2568239, "longitude": -97.7245513 }, "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/tTIAWYxFat7PSRu1Gbazkw/o.jpg" }, { "business_id": "AyrhZPOm5BCSTN_hl-_xrg", "alias": "swedish-hill-austin-7", "name": "Swedish Hill", "rating": 4.5, "review_count": 18, "price_level": "$$", "is_closed": false, "phone": "(512) 882-6610", "yelp_url": "https://www.yelp.com/biz/swedish-hill-austin-7", "categories": [ { "alias": "cafes", "title": "Cafes" }, { "alias": "bakeries", "title": "Bakeries" }, { "alias": "delis", "title": "Delis" } ], "neighborhoods": [ "Warehouse District", "Downtown" ], "address": { "line1": "415 Colorado St", "city": "Austin", "state": "TX", "postal_code": "78701", "country_code": "US", "formatted": "415 Colorado St, Unit 102, Austin, TX 78701" }, "coordinates": { "latitude": 30.267103909890537, "longitude": -97.74430223241814 }, "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/Yr0bYXRFHzkT_1a6bZVfPQ/o.jpg" } ] }, "meta": { "request_id": "fd70b8df-859c-43f0-802f-71a798a4042b", "endpoint": "/v1/yelp/search", "items_returned": 20, "credits_charged": 100, "cached": true, "took_ms": 1 } } } } }, "400": { "description": "Missing or invalid query parameter (0 credits charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid rv_live_ API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Insufficient credit balance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/yelp/reviews": { "get": { "operationId": "v1_yelp_reviews", "tags": [ "Yelp Local Business" ], "summary": "Extract full Yelp customer reviews & sentiment polarity (no 3-review cap)", "description": "Bypasses the official Yelp Fusion 3-review truncation cap ($7.99–$19.99/1K) to return full-text Yelp customer reviews, 5-star histogram, aspect polarity tags, useful/funny/cool reactions, and business owner replies.", "x-price-per-request": "$0.0002 / review ($0.08–$0.20 / 1K reviews)", "x-credits-per-request": "2 Credits / review (0 Credits on empty)", "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "parameters": [ { "name": "alias", "in": "query", "required": false, "description": "Yelp business slug alias (e.g. houndstooth-coffee-austin). Provide alias or business_id.", "example": "houndstooth-coffee-austin", "schema": { "type": "string" } }, { "name": "business_id", "in": "query", "required": false, "description": "Encrypted Yelp business_id (alternative to alias).", "example": "6i-32-12abc", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "1-based page number.", "example": 1, "schema": { "type": "integer", "default": 1, "minimum": 1 } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum reviews to return (1–50).", "example": 20, "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 50 } } ], "responses": { "200": { "description": "Normalized cross-platform reputation, star distribution, and sentiment JSON payload.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1YelpReviewsResponse" }, "example": { "code": 0, "provider": "https://reviewsdataapi.com", "status": "ok", "msg": "success", "data": { "platform": "yelp", "business_id": "houndstooth-coffee-austin", "sentiment_summary": { "sampled_reviews": 20, "average_rating": 3.8, "star_distribution": { "1": 1, "2": 3, "3": 3, "4": 5, "5": 8 }, "star_percentages": { "1": 5, "2": 15, "3": 15, "4": 25, "5": 40 }, "sentiment_breakdown": { "positive_pct": 65, "neutral_pct": 15, "negative_pct": 20, "net_polarity_score": 0.44 }, "aspect_polarities": [ { "aspect": "Customer Support", "polarity": "positive", "positive_pct": 75, "mentions": 8 }, { "aspect": "Quality & Reliability", "polarity": "positive", "positive_pct": 80, "mentions": 5 } ] }, "language_counts": { "en": 604 }, "reviews": [ { "review_id": "MTthLbOl1VBdGw0C7qREjA", "platform": "yelp", "business_id": "houndstooth-coffee-austin", "rating": 5, "review_text": "I enjoy visiting local coffee shops. I was in search of an afternoon coffee and came across Houndstooth on the Yelp app.\n\nParking can be tricky. A lot of spots are reserved for valet parking for Uchiko. I was able to find a spot up front, however I did not realize it was short term parking (10 minutes). Luckily, I was planning to get my coffee to go. Ther...", "language": "en", "is_featured": false, "published_at": "2024-10-07T22:36:00.000Z", "sentiment": "positive", "polarity_score": 0.93, "feedback": { "useful": 10, "funny": 3, "cool": 13 }, "author": { "id": "7Pk5rbkeZ2_xAPpOPjmRrg", "name": "Tiffany J.", "location": "Houston, TX", "total_reviews": 1069, "friend_count": 571, "avatar_url": "https://s3-media0.fl.yelpcdn.com/photo/X0InG8O9apnMdynq261XGg/ms.jpg" }, "owner_reply": null }, { "review_id": "2z-ofo5QZbYicP_RmH0yCQ", "platform": "yelp", "business_id": "houndstooth-coffee-austin", "rating": 4, "review_text": "Went to Houndstooth Coffee around 7 am and it was a really nice way to start the day. Super peaceful and quiet, which is exactly what you want that early in the morning.\n\nI got a latte and a chai latte and both were pretty solid, definitely above average. Nothing crazy or experimental, just well made drinks that hit the spot.\n\nSeating is a bit limited, so...", "language": "en", "is_featured": false, "published_at": "2026-03-25T17:32:47.000Z", "sentiment": "positive", "polarity_score": 0.74, "feedback": { "useful": 0, "funny": 0, "cool": 0 }, "author": { "id": "cev9dM31_H7Tv47p03J8yQ", "name": "Wes Y.", "location": "Carson, CA", "total_reviews": 55, "friend_count": 1, "avatar_url": "https://s3-media0.fl.yelpcdn.com/photo/66Y4-Gd_8f0JsODrBEH9hg/ms.jpg" }, "owner_reply": null } ] }, "meta": { "request_id": "999de78a-7f68-45a3-8bd4-ffb78a776e1b", "endpoint": "/v1/yelp/reviews", "items_returned": 20, "credits_charged": 40, "cached": true, "took_ms": 0 } } } } }, "400": { "description": "Missing or invalid query parameter (0 credits charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid rv_live_ API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Insufficient credit balance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/tripadvisor/search": { "get": { "operationId": "v1_tripadvisor_search", "tags": [ "TripAdvisor Hospitality" ], "summary": "Search TripAdvisor destinations, hotels, restaurants & geo_id locations", "description": "Resolves cities, hotels, attractions, and restaurants on TripAdvisor into canonical geo_id and location_id records with bubble ratings, review counts, thumbnails, and GPS coordinates.", "x-price-per-request": "$0.0005 / location ($0.20–$0.50 / 1K locations)", "x-credits-per-request": "5 Credits / location (0 Credits on empty)", "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "parameters": [ { "name": "query", "in": "query", "required": true, "description": "City, hotel, landmark, or restaurant name (e.g. Paris, Ritz Paris).", "example": "Paris", "schema": { "type": "string" } }, { "name": "lang", "in": "query", "required": false, "description": "Locale code (default en_US).", "example": "en_US", "schema": { "type": "string", "default": "en_US" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum locations to return (1–30).", "example": 10, "schema": { "type": "integer", "default": 10, "minimum": 1, "maximum": 30 } } ], "responses": { "200": { "description": "Normalized cross-platform reputation, star distribution, and sentiment JSON payload.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1TripadvisorSearchResponse" }, "example": { "code": 0, "provider": "https://reviewsdataapi.com", "status": "ok", "msg": "success", "data": { "platform": "tripadvisor", "query": "Paris", "locations": [ { "location_id": "187147", "geo_id": "187147", "result_type": "geos", "name": "Paris", "location_string": "Paris, Ile-de-France", "rating": null, "review_count": 5645698, "timezone": "Europe/Paris", "coordinates": { "latitude": 48.857037, "longitude": 2.349401 }, "photo_url": "https://media-cdn.tripadvisor.com/media/photo-s/17/15/6d/d6/paris.jpg" }, { "location_id": "189229", "geo_id": "189229", "result_type": "things_to_do", "name": "The Paris Catacombs", "location_string": "Paris, Ile-de-France", "rating": 4.1, "review_count": 8537, "timezone": "Europe/Paris", "coordinates": { "latitude": 48.83387, "longitude": 2.332481 }, "photo_url": "https://media-cdn.tripadvisor.com/media/photo-s/01/00/c4/f4/a-place-to-pray.jpg" } ] }, "meta": { "request_id": "7ff97937-3631-4e67-a80a-fb442a4cfa85", "endpoint": "/v1/tripadvisor/search", "items_returned": 20, "credits_charged": 100, "cached": true, "took_ms": 1 } } } } }, "400": { "description": "Missing or invalid query parameter (0 credits charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid rv_live_ API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Insufficient credit balance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/tripadvisor/restaurants": { "get": { "operationId": "v1_tripadvisor_restaurants", "tags": [ "TripAdvisor Hospitality" ], "summary": "List ranked TripAdvisor restaurants & hospitality reputation by geo_id", "description": "Returns TripAdvisor restaurant listings for a destination geo_id (e.g. 187147 for Paris) with bubble rating, total review count, price tier, cuisine tags, open status, and Travellers' Choice award indicators.", "x-price-per-request": "$0.0005 / restaurant ($0.20–$0.50 / 1K restaurants)", "x-credits-per-request": "5 Credits / restaurant (0 Credits on empty)", "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "parameters": [ { "name": "geo_id", "in": "query", "required": true, "description": "TripAdvisor destination geo_id from /v1/tripadvisor/search (e.g. 187147 for Paris).", "example": "187147", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "1-based page number.", "example": 1, "schema": { "type": "integer", "default": 1, "minimum": 1 } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum restaurants to return (1–50).", "example": 20, "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 50 } } ], "responses": { "200": { "description": "Normalized cross-platform reputation, star distribution, and sentiment JSON payload.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1TripadvisorRestaurantsResponse" }, "example": { "code": 0, "provider": "https://reviewsdataapi.com", "status": "ok", "msg": "success", "data": { "platform": "tripadvisor", "geo_id": "187147", "restaurants": [ { "location_id": "14039269", "geo_id": "187147", "name": "Can Alegria Paris", "rating": 4.8, "review_count": 1647, "popularity_rank": 117, "price_range": "$$ - $$$", "cuisines": [ "French", "Mediterranean", "Vegetarian friendly" ], "neighborhood": "Saint-Georges", "travellers_choice_badge": "TRAVELLER_CHOICE 2026", "tripadvisor_url": "https://www.tripadvisor.com/Restaurant_Review-g187147-d14039269" }, { "location_id": "34162331", "geo_id": "187147", "name": "Pizzeria Arrivederci (4ème)", "rating": 4.9, "review_count": 749, "popularity_rank": 1, "price_range": "$$ - $$$", "cuisines": [ "Italian", "Pizza" ], "neighborhood": "Le Marais", "travellers_choice_badge": null, "tripadvisor_url": "https://www.tripadvisor.com/Restaurant_Review-g187147-d34162331" } ] }, "meta": { "request_id": "a44353f9-f188-454c-9a44-9ac3fbf08069", "endpoint": "/v1/tripadvisor/restaurants", "items_returned": 20, "credits_charged": 100, "cached": true, "took_ms": 1 } } } } }, "400": { "description": "Missing or invalid query parameter (0 credits charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid rv_live_ API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Insufficient credit balance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/google-play/reviews": { "get": { "operationId": "v1_google_play_reviews", "tags": [ "Mobile App Stores" ], "summary": "Stream Google Play Store Android app reviews, star histogram & developer replies", "description": "Extracts real-time Google Play Store Android customer reviews for any package ID (e.g. com.spotify.music) with 5-star distribution histogram, aspect polarity tags, app_version, thumbs-up count, and developer reply.", "x-price-per-request": "$0.0002 / review ($0.08–$0.20 / 1K reviews)", "x-credits-per-request": "2 Credits / review (0 Credits on empty)", "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "parameters": [ { "name": "app_id", "in": "query", "required": true, "description": "Android package identifier (e.g. com.spotify.music, com.whatsapp).", "example": "com.spotify.music", "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "description": "2-letter ISO storefront country code.", "example": "us", "schema": { "type": "string", "default": "us" } }, { "name": "lang", "in": "query", "required": false, "description": "2-letter language code.", "example": "en", "schema": { "type": "string", "default": "en" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum reviews to return (1–100).", "example": 20, "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 100 } } ], "responses": { "200": { "description": "Normalized cross-platform reputation, star distribution, and sentiment JSON payload.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1GooglePlayReviewsResponse" }, "example": { "code": 0, "provider": "https://reviewsdataapi.com", "status": "ok", "msg": "success", "data": { "platform": "google_play", "app_id": "com.spotify.music", "country": "us", "lang": "en", "sentiment_summary": { "sampled_reviews": 20, "average_rating": 3.5, "star_distribution": { "1": 6, "2": 0, "3": 2, "4": 2, "5": 10 }, "star_percentages": { "1": 30, "2": 0, "3": 10, "4": 10, "5": 50 }, "sentiment_breakdown": { "positive_pct": 60, "neutral_pct": 10, "negative_pct": 30, "net_polarity_score": 0.24 }, "aspect_polarities": [ { "aspect": "Ease of Use & UX", "polarity": "positive", "positive_pct": 67, "mentions": 6 }, { "aspect": "Quality & Reliability", "polarity": "mixed", "positive_pct": 50, "mentions": 2 } ] }, "reviews": [ { "review_id": "9b85aa9d-ebba-4ab4-9a01-8a3405d9421d", "platform": "google_play", "app_id": "com.spotify.music", "rating": 4, "review_text": "👍", "thumbs_up_count": 0, "app_version": "9.1.92.3058", "published_at": "2026-11-13T17:32:14.000Z", "sentiment": "positive", "polarity_score": 0.5, "author": { "id": "102329741725494484696", "name": "ABACAR abubacar Molide", "avatar_url": "https://play-lh.googleusercontent.com/a-/ALV-UjUFi9NHaWXcKjbYFsAs4j3JbJ6ECqzUz5GT3hqzlJ6RnHvlja8K" }, "developer_reply": null }, { "review_id": "31862060-bbe2-4ec8-b44b-751368201950", "platform": "google_play", "app_id": "com.spotify.music", "rating": 5, "review_text": "everything looks so perfect", "thumbs_up_count": 0, "app_version": "9.1.98.621", "published_at": "2026-11-13T17:29:39.000Z", "sentiment": "positive", "polarity_score": 0.93, "author": { "id": "113857439280032288672", "name": "Fareed Ahmed", "avatar_url": "https://play-lh.googleusercontent.com/a-/ALV-UjVrLkWpdLdXRke6fRC0PdDPeEJTqxwxljXtqAkDcLpgLDX8zhjc" }, "developer_reply": null } ], "next_cursor": "Cs4BIsUBARqIumh6GI49EPhr1UOeDEV-OAi2I_e_4A4_vJFRjCzlXgku0IN3RagNW-uaxlkYEvf1pcqhrBSJFCNGKeHb0epSr2hLQ4cDRMkldmHzYjKBCYuxHBBYs0v-Beop7AD5F84d1ehdTzCvOuJhLs23R14BhGtrq67636ybdI1acCfTqCcZYX7b3fgX5owIIa6DgcxGCHy1XzFjoIAh_NyR-6k96r9pyoWqOFUcV3RQwLKtMEbzvTHpYpZ-G_HZ1ABjKE_W-Bsovrfi1wY" }, "meta": { "request_id": "6297fbd8-5738-4c14-a071-aa8afc15aa75", "endpoint": "/v1/google-play/reviews", "items_returned": 20, "credits_charged": 40, "cached": false, "took_ms": 130 } } } } }, "400": { "description": "Missing or invalid query parameter (0 credits charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid rv_live_ API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Insufficient credit balance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/app-store/reviews": { "get": { "operationId": "v1_app_store_reviews", "tags": [ "Mobile App Stores" ], "summary": "Fetch Apple App Store iOS customer reviews, version ratings & sentiment polarity", "description": "Fetches real-time Apple App Store iOS customer reviews across 175+ country storefronts by numeric track ID (e.g. 324684580 for Spotify) with version strings, vote sums, 5-star distribution, and aspect sentiment polarity.", "x-price-per-request": "$0.0002 / review ($0.08–$0.20 / 1K reviews)", "x-credits-per-request": "2 Credits / review (0 Credits on empty)", "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "parameters": [ { "name": "app_id", "in": "query", "required": true, "description": "Numeric Apple App Store track ID (accepts 324684580 or id324684580).", "example": "324684580", "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "description": "2-letter ISO country storefront (e.g. us, gb, de, jp).", "example": "us", "schema": { "type": "string", "default": "us" } }, { "name": "page", "in": "query", "required": false, "description": "1-based RSS page index (1–10).", "example": 1, "schema": { "type": "integer", "default": 1, "minimum": 1, "maximum": 10 } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum reviews to return (1–50).", "example": 20, "schema": { "type": "integer", "default": 20, "minimum": 1, "maximum": 50 } } ], "responses": { "200": { "description": "Normalized cross-platform reputation, star distribution, and sentiment JSON payload.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1AppStoreReviewsResponse" }, "example": { "code": 0, "provider": "https://reviewsdataapi.com", "status": "ok", "msg": "success", "data": { "platform": "app_store", "app_id": "324684580", "country": "us", "page": 1, "sentiment_summary": { "sampled_reviews": 20, "average_rating": 3.6, "star_distribution": { "1": 4, "2": 3, "3": 1, "4": 1, "5": 11 }, "star_percentages": { "1": 20, "2": 15, "3": 5, "4": 5, "5": 55 }, "sentiment_breakdown": { "positive_pct": 60, "neutral_pct": 5, "negative_pct": 35, "net_polarity_score": 0.29 }, "aspect_polarities": [ { "aspect": "Pricing & Billing", "polarity": "negative", "positive_pct": 33, "mentions": 6 }, { "aspect": "Ease of Use & UX", "polarity": "mixed", "positive_pct": 60, "mentions": 5 } ] }, "reviews": [ { "review_id": "14785065897", "platform": "app_store", "app_id": "324684580", "country": "us", "rating": 5, "title": "Meow", "review_text": "I have premium so it’s actually useable 😭 but I really like Spotify because I can listen to music all day and it doesn’t just randomly stop or anything, like SoundCloud or other music apps", "app_version": "9.1.98", "vote_sum": 0, "vote_count": 0, "published_at": "2026-11-13T03:59:05-07:00", "sentiment": "positive", "polarity_score": 0.85, "author": { "name": "The real Miku ✌️", "profile_url": "https://itunes.apple.com/us/reviews/id1901157728" } }, { "review_id": "14785059121", "platform": "app_store", "app_id": "324684580", "country": "us", "rating": 5, "title": "House of memories", "review_text": "Great song", "app_version": "9.1.98", "vote_sum": 0, "vote_count": 0, "published_at": "2026-11-13T03:56:51-07:00", "sentiment": "positive", "polarity_score": 0.93, "author": { "name": "Sillyataco", "profile_url": "https://itunes.apple.com/us/reviews/id1763603696" } } ] }, "meta": { "request_id": "14c5188d-1dd1-4fc0-a37f-58b3531a8325", "endpoint": "/v1/app-store/reviews", "items_returned": 20, "credits_charged": 40, "cached": true, "took_ms": 0 } } } } }, "400": { "description": "Missing or invalid query parameter (0 credits charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid rv_live_ API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Insufficient credit balance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/glassdoor/companies": { "get": { "operationId": "v1_glassdoor_companies", "tags": [ "Glassdoor Employer Reputation" ], "summary": "Search Glassdoor employer profiles, company_id, CEO approval & sub-ratings", "description": "Searches Glassdoor companies by name or domain (aliases: /v1/glassdoor/search, /v1/glassdoor/company-search, /v1/glassdoor/company) and returns numeric company_id, overall rating, total review/salary/job counts, CEO approval rate, recommend-to-friend rate, business outlook, and 6 workplace sub-ratings.", "x-price-per-request": "$0.0005 / company ($0.20–$0.50 / 1K companies)", "x-credits-per-request": "5 Credits / company (0 Credits on empty)", "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "parameters": [ { "name": "query", "in": "query", "required": true, "description": "Company or employer name to search on Glassdoor (e.g. Printful, Stripe, Notion).", "example": "Printful", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum matching companies to return (1–50).", "example": 10, "schema": { "type": "integer", "default": 10, "minimum": 1, "maximum": 50 } }, { "name": "fresh", "in": "query", "required": false, "description": "Bypass 6-hour warm cache for live pull (paid/subscribed accounts).", "example": false, "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Normalized Glassdoor employer profiles and workplace sub-ratings.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1GlassdoorCompaniesResponse" }, "example": { "code": 0, "provider": "https://reviewsdataapi.com", "status": "ok", "msg": "success", "data": { "platform": "glassdoor", "query": "Printful", "companies": [ { "company_id": "1001330", "platform": "glassdoor", "name": "Printful", "website": "https://www.printful.com", "domain": "printful.com", "glassdoor_url": "https://www.glassdoor.com/Overview/Working-at-Printful-EI_IE1001330.11,19.htm", "rating": 4, "review_count": 342, "salary_count": 195, "job_count": 38, "headquarters_location": "Charlotte, NC", "company_size": "1001 to 5000 Employees", "industry": "Internet & Web Services", "ceo": "Alex Saltonstall", "ceo_approval_rate": 0.82, "recommend_to_friend_rate": 0.78, "business_outlook_rate": 0.71, "sub_ratings": { "work_life_balance": 4.1, "culture_and_values": 4.2, "career_opportunities": 3.7, "compensation_and_benefits": 3.7, "senior_management": 3.8, "diversity_and_inclusion": 4.3 } } ] }, "meta": { "request_id": "8b90d11c-4210-4f21-9c9a-1001330a1b2c", "endpoint": "/v1/glassdoor/companies", "items_returned": 9, "credits_charged": 45, "cached": false, "took_ms": 1890 } } } } }, "400": { "description": "Missing or invalid query parameter (0 credits charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid rv_live_ API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Insufficient credit balance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/glassdoor/reviews": { "get": { "operationId": "v1_glassdoor_reviews", "tags": [ "Glassdoor Employer Reputation" ], "summary": "Extract Glassdoor employee Pros/Cons reviews, 5-star histogram & sentiment polarity", "description": "Fetches paginated Glassdoor employee reviews by numeric company_id (e.g. 1001330) OR by company name query (automatically resolves company_id first). Includes Pros, Cons, Advice to Management, job title, employment status, workplace sub-ratings, 1–5 star distribution histogram, and aspect sentiment polarities.", "x-price-per-request": "$0.0002 / review ($0.08–$0.20 / 1K reviews)", "x-credits-per-request": "2 Credits / review (0 Credits on empty)", "security": [ { "ApiKeyHeader": [] }, { "BearerAuth": [] } ], "parameters": [ { "name": "company_id", "in": "query", "required": false, "description": "Numeric Glassdoor employer ID (e.g. 1001330 for Printful). Optional if query is provided.", "example": "1001330", "schema": { "type": "string" } }, { "name": "query", "in": "query", "required": false, "description": "Employer name (e.g. Printful). Automatically resolves company_id when company_id is omitted.", "example": "Printful", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "1-based page number (10 reviews per page).", "example": 1, "schema": { "type": "integer", "default": 1, "minimum": 1, "maximum": 500 } }, { "name": "sort", "in": "query", "required": false, "description": "Review sort order.", "example": "POPULAR", "schema": { "type": "string", "enum": [ "POPULAR", "MOST_RECENT", "HIGHEST_RATING", "LOWEST_RATING" ], "default": "POPULAR" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum reviews to return (1–50).", "example": 10, "schema": { "type": "integer", "default": 10, "minimum": 1, "maximum": 50 } }, { "name": "fresh", "in": "query", "required": false, "description": "Bypass 6-hour warm cache for live pull (paid/subscribed accounts).", "example": false, "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Normalized Glassdoor employee Pros/Cons reviews, 5-star histogram, and aspect sentiment polarities.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1GlassdoorReviewsResponse" }, "example": { "code": 0, "provider": "https://reviewsdataapi.com", "status": "ok", "msg": "success", "data": { "platform": "glassdoor", "company_id": "1001330", "sentiment_summary": { "sampled_reviews": 10, "average_rating": 4.1, "star_distribution": { "1": 0, "2": 1, "3": 1, "4": 4, "5": 4 }, "star_percentages": { "1": 0, "2": 10, "3": 10, "4": 40, "5": 40 }, "sentiment_breakdown": { "positive_pct": 80, "neutral_pct": 10, "negative_pct": 10, "net_polarity_score": 0.56 }, "aspect_polarities": [ { "aspect": "Work-Life Balance", "polarity": "positive", "positive_pct": 88, "mentions": 8 }, { "aspect": "Culture & Values", "polarity": "positive", "positive_pct": 86, "mentions": 7 } ] }, "reviews": [ { "review_id": "89412018", "platform": "glassdoor", "company_id": "1001330", "rating": 5, "title": "Supportive engineering culture and genuine work-life balance", "pros": "Flexible hybrid work policy, modern TypeScript/cloud stack, and genuinely supportive teammates across Riga and Charlotte.", "cons": "Q4 peak e-commerce fulfillment season gets fast-paced across product teams.", "advice_to_management": "Keep investing in internal developer tooling.", "job_title": "Senior Software Engineer", "employment_status": "REGULAR", "is_current_employee": true, "location": "Charlotte, NC", "helpful_count": 6, "published_at": "2026-10-18T14:22:00.000Z", "sentiment": "positive", "polarity_score": 0.93 } ], "pagination": { "page": 1, "per_page": 10, "total_reviews": 342, "total_pages": 35, "has_more": true } }, "meta": { "request_id": "7a12f44b-1001-4330-9f12-89412018abcd", "endpoint": "/v1/glassdoor/reviews", "items_returned": 10, "credits_charged": 20, "cached": false, "took_ms": 2150 } } } } }, "400": { "description": "Missing or invalid query parameter (0 credits charged).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid rv_live_ API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "Insufficient credit balance.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } } }, "components": { "securitySchemes": { "ApiKeyHeader": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Your rv_live_... API key from https://reviewsdataapi.com/dashboard" }, "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Authorization: Bearer rv_live_... or OAuth 2.1 mcp_at_... token" } }, "schemas": { "ErrorResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": -1 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "error" }, "msg": { "type": "string", "example": "Invalid API key or missing required parameter." } } }, "V1TrustpilotReviewsResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "platform": { "type": "string", "example": "trustpilot" }, "domain": { "type": "string", "example": "printful.com" }, "sentiment_summary": { "type": "object", "properties": { "sampled_reviews": { "type": "integer", "example": 20 }, "average_rating": { "type": "number", "example": 3.35 }, "star_distribution": { "type": "object", "properties": { "1": { "type": "integer", "example": 6 }, "2": { "type": "integer", "example": 2 }, "3": { "type": "integer", "example": 1 }, "4": { "type": "integer", "example": 1 }, "5": { "type": "integer", "example": 10 } } }, "star_percentages": { "type": "object", "properties": { "1": { "type": "integer", "example": 30 }, "2": { "type": "integer", "example": 10 }, "3": { "type": "integer", "example": 5 }, "4": { "type": "integer", "example": 5 }, "5": { "type": "integer", "example": 50 } } }, "sentiment_breakdown": { "type": "object", "properties": { "positive_pct": { "type": "integer", "example": 55 }, "neutral_pct": { "type": "integer", "example": 5 }, "negative_pct": { "type": "integer", "example": 40 }, "net_polarity_score": { "type": "number", "example": 0.2 } } }, "aspect_polarities": { "type": "array", "items": { "type": "object", "properties": { "aspect": { "type": "string", "example": "Speed & Delivery" }, "polarity": { "type": "string", "example": "negative" }, "positive_pct": { "type": "integer", "example": 20 }, "mentions": { "type": "integer", "example": 5 } } } } } }, "reviews": { "type": "array", "items": { "type": "object", "properties": { "review_id": { "type": "string", "example": "6af7acc1fd941bbb375cca9a" }, "platform": { "type": "string", "example": "trustpilot" }, "domain": { "type": "string", "example": "printful.com" }, "review_url": { "type": "string", "example": "https://www.trustpilot.com/reviews/6af7acc1fd941bbb375cca9a" }, "rating": { "type": "integer", "example": 5 }, "title": { "type": "string", "example": "so easy to integrate" }, "review_text": { "type": "string", "example": "so easy to integrate" }, "verified": { "type": "boolean", "example": false }, "verification_level": { "type": "string", "example": "BasicLink" }, "language": { "type": "string", "example": "en" }, "likes_count": { "type": "integer", "example": 0 }, "published_at": { "type": "string", "example": "2026-11-14T02:35:13.000Z" }, "experienced_at": { "type": "string", "example": "2026-10-01T00:00:00.000Z" }, "sentiment": { "type": "string", "example": "positive" }, "polarity_score": { "type": "number", "example": 0.93 }, "author": { "type": "object", "properties": { "id": { "type": "string", "example": "6a83542117a86039c7aa75e4" }, "name": { "type": "string", "example": "Enith Dali Morales Rios" }, "country_code": { "type": "string", "example": "US" }, "total_reviews": { "type": "integer", "example": 2 }, "is_verified_reviewer": { "type": "boolean", "example": false }, "avatar_url": { "type": "string", "description": "Optional field (nullable)" } } }, "company_reply": { "type": "string", "description": "Optional field (nullable)" } } } }, "pagination": { "type": "object", "properties": { "page": { "type": "integer", "example": 1 }, "per_page": { "type": "integer", "example": 20 }, "total_reviews": { "type": "integer", "example": 7453 }, "total_pages": { "type": "integer", "example": 373 }, "has_more": { "type": "boolean", "example": true }, "rating_distribution": { "type": "object", "properties": { "1": { "type": "integer", "example": 890 }, "2": { "type": "integer", "example": 186 }, "3": { "type": "integer", "example": 186 }, "4": { "type": "integer", "example": 481 }, "5": { "type": "integer", "example": 6255 } } } } } } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string", "example": "9989985f-997a-48e7-a66f-4e8231b0b8ea" }, "endpoint": { "type": "string", "example": "/v1/trustpilot/reviews" }, "items_returned": { "type": "integer", "example": 20 }, "credits_charged": { "type": "integer", "example": 40 }, "cached": { "type": "boolean", "example": false }, "took_ms": { "type": "integer", "example": 1256 } } } } }, "V1TrustpilotCompanyResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "platform": { "type": "string", "example": "trustpilot" }, "company": { "type": "object", "properties": { "company_id": { "type": "string", "example": "5aa7f1850c6df00001be09bc" }, "domain": { "type": "string", "example": "printful.com" }, "display_name": { "type": "string", "example": "Printful" }, "trust_score": { "type": "number", "example": 4.1 }, "stars": { "type": "integer", "example": 4 }, "total_reviews": { "type": "integer", "example": 7998 }, "is_claimed": { "type": "boolean", "example": true }, "is_closed": { "type": "boolean", "example": false }, "website_url": { "type": "string", "example": "https://www.printful.com/" }, "trustpilot_url": { "type": "string", "example": "https://www.trustpilot.com/review/printful.com" }, "logo_url": { "type": "string", "example": "https://s3-eu-west-1.amazonaws.com/tpd/logos/5aa7f1850c6df00001be09bc/0x0.png" }, "about": { "type": "string", "example": "We’re Printful, an on-demand printing and fulfillment company that helps people " }, "ai_summary": { "type": "object", "properties": { "summary_text": { "type": "string", "example": "Evaluating 897 reviews, reviewers had a great experience with this company. Cons" }, "summary_created_from_review_ids": { "type": "string", "description": "Optional field (nullable)" }, "ai_summarized_reviews": { "type": "array", "items": { "type": "object", "properties": { "review_id": { "type": "string", "example": "6ac4bc0a31975631f2c68bd2" }, "review_link": { "type": "string", "example": "https://www.trustpilot.com/reviews/6ac4bc0a31975631f2c68bd2" }, "title": { "type": "string", "example": "Mostly it works well" }, "text": { "type": "string", "example": "Mostly it works well, but there are some issues with synching featured images of" }, "rating": { "type": "integer", "example": 4 }, "language": { "type": "string", "example": "en" }, "is_verified": { "type": "boolean", "example": false }, "is_pending": { "type": "boolean", "example": false }, "source": { "type": "string", "example": "BasicLink" }, "published_at_date": { "type": "string", "example": "2026-10-06T11:14:50.000Z" }, "experience_date": { "type": "string", "example": "2026-10-06T00:00:00.000Z" }, "likes_count": { "type": "integer", "example": 0 }, "company_reply": { "type": "string", "example": "We're glad it mostly works well. We hear you on image syncing and group publishi" }, "company_reply_date": { "type": "string", "example": "2026-10-07T07:41:58.000Z" }, "reviewer": { "type": "object", "properties": { "id": { "type": "string", "example": "67aa24a5bbb6ea2a5e34a8c4" }, "profile_link": { "type": "string", "example": "https://www.trustpilot.com/users/67aa24a5bbb6ea2a5e34a8c4" }, "name": { "type": "string", "example": "Valued Customer" }, "country_code": { "type": "string", "example": "US" }, "is_verified": { "type": "boolean", "example": false }, "avatar_url": { "type": "string", "description": "Optional field (nullable)" }, "total_reviews": { "type": "integer", "example": 2 }, "reviews_on_this_company": { "type": "integer", "example": 1 } } } } } } } }, "country_code": { "type": "string", "example": "US" }, "rating_distribution": { "type": "object", "properties": { "1": { "type": "integer", "example": 890 }, "2": { "type": "integer", "example": 186 }, "3": { "type": "integer", "example": 186 }, "4": { "type": "integer", "example": 481 }, "5": { "type": "integer", "example": 6255 } } }, "negative_reviews_reply_percent": { "type": "number", "example": 99.59677419354838 }, "average_days_to_reply": { "type": "number", "example": 0.15 }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "custom_t_shirt_store" }, "name": { "type": "string", "example": "" }, "is_primary": { "type": "boolean", "example": false } } } }, "contact": { "type": "object", "properties": { "email": { "type": "string", "example": "support@printful.com" }, "phone": { "type": "string", "description": "Optional field (nullable)" }, "address": { "type": "string", "example": "11025 Westlake Dr, Charlotte, 28273, US" }, "city": { "type": "string", "example": "Charlotte" }, "zip_code": { "type": "string", "example": "28273" }, "country": { "type": "string", "example": "US" } } }, "verification": { "type": "object", "properties": { "verified_payment_method": { "type": "boolean", "example": true }, "verified_business": { "type": "boolean", "example": true } } } } } } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string", "example": "34ad7490-6016-4fb5-be89-678b6ce52d23" }, "endpoint": { "type": "string", "example": "/v1/trustpilot/company" }, "items_returned": { "type": "integer", "example": 1 }, "credits_charged": { "type": "integer", "example": 10 }, "cached": { "type": "boolean", "example": false }, "took_ms": { "type": "integer", "example": 1153 } } } } }, "V1YelpSearchResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "platform": { "type": "string", "example": "yelp" }, "query": { "type": "string", "example": "coffee" }, "location": { "type": "string", "example": "Austin, TX" }, "total_estimated": { "type": "integer", "example": 240 }, "businesses": { "type": "array", "items": { "type": "object", "properties": { "business_id": { "type": "string", "example": "0wljsy6_0HIni0pooc5ozw" }, "alias": { "type": "string", "example": "mr-natural-austin" }, "name": { "type": "string", "example": "Mr Natural" }, "rating": { "type": "number", "example": 3.9 }, "review_count": { "type": "integer", "example": 535 }, "price_level": { "type": "string", "example": "$$" }, "is_closed": { "type": "boolean", "example": false }, "phone": { "type": "string", "example": "(512) 477-5228" }, "yelp_url": { "type": "string", "example": "https://www.yelp.com/biz/mr-natural-austin" }, "categories": { "type": "array", "items": { "type": "object", "properties": { "alias": { "type": "string", "example": "vegetarian" }, "title": { "type": "string", "example": "Vegetarian" } } } }, "neighborhoods": { "type": "array", "items": { "type": "string", "example": "East Cesar Chavez" } }, "address": { "type": "object", "properties": { "line1": { "type": "string", "example": "1901 E Cesar Chavez St" }, "city": { "type": "string", "example": "Austin" }, "state": { "type": "string", "example": "TX" }, "postal_code": { "type": "string", "example": "78702" }, "country_code": { "type": "string", "example": "US" }, "formatted": { "type": "string", "example": "1901 E Cesar Chavez St, Austin, TX 78702" } } }, "coordinates": { "type": "object", "properties": { "latitude": { "type": "number", "example": 30.2568239 }, "longitude": { "type": "number", "example": -97.7245513 } } }, "photo_url": { "type": "string", "example": "https://s3-media0.fl.yelpcdn.com/bphoto/tTIAWYxFat7PSRu1Gbazkw/o.jpg" } } } } } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string", "example": "fd70b8df-859c-43f0-802f-71a798a4042b" }, "endpoint": { "type": "string", "example": "/v1/yelp/search" }, "items_returned": { "type": "integer", "example": 20 }, "credits_charged": { "type": "integer", "example": 100 }, "cached": { "type": "boolean", "example": true }, "took_ms": { "type": "integer", "example": 1 } } } } }, "V1YelpReviewsResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "platform": { "type": "string", "example": "yelp" }, "business_id": { "type": "string", "example": "houndstooth-coffee-austin" }, "sentiment_summary": { "type": "object", "properties": { "sampled_reviews": { "type": "integer", "example": 20 }, "average_rating": { "type": "number", "example": 3.8 }, "star_distribution": { "type": "object", "properties": { "1": { "type": "integer", "example": 1 }, "2": { "type": "integer", "example": 3 }, "3": { "type": "integer", "example": 3 }, "4": { "type": "integer", "example": 5 }, "5": { "type": "integer", "example": 8 } } }, "star_percentages": { "type": "object", "properties": { "1": { "type": "integer", "example": 5 }, "2": { "type": "integer", "example": 15 }, "3": { "type": "integer", "example": 15 }, "4": { "type": "integer", "example": 25 }, "5": { "type": "integer", "example": 40 } } }, "sentiment_breakdown": { "type": "object", "properties": { "positive_pct": { "type": "integer", "example": 65 }, "neutral_pct": { "type": "integer", "example": 15 }, "negative_pct": { "type": "integer", "example": 20 }, "net_polarity_score": { "type": "number", "example": 0.44 } } }, "aspect_polarities": { "type": "array", "items": { "type": "object", "properties": { "aspect": { "type": "string", "example": "Customer Support" }, "polarity": { "type": "string", "example": "positive" }, "positive_pct": { "type": "integer", "example": 75 }, "mentions": { "type": "integer", "example": 8 } } } } } }, "language_counts": { "type": "object", "properties": { "en": { "type": "integer", "example": 604 } } }, "reviews": { "type": "array", "items": { "type": "object", "properties": { "review_id": { "type": "string", "example": "MTthLbOl1VBdGw0C7qREjA" }, "platform": { "type": "string", "example": "yelp" }, "business_id": { "type": "string", "example": "houndstooth-coffee-austin" }, "rating": { "type": "integer", "example": 5 }, "review_text": { "type": "string", "example": "I enjoy visiting local coffee shops. I was in search of an afternoon coffee and " }, "language": { "type": "string", "example": "en" }, "is_featured": { "type": "boolean", "example": false }, "published_at": { "type": "string", "example": "2024-10-07T22:36:00.000Z" }, "sentiment": { "type": "string", "example": "positive" }, "polarity_score": { "type": "number", "example": 0.93 }, "feedback": { "type": "object", "properties": { "useful": { "type": "integer", "example": 10 }, "funny": { "type": "integer", "example": 3 }, "cool": { "type": "integer", "example": 13 } } }, "author": { "type": "object", "properties": { "id": { "type": "string", "example": "7Pk5rbkeZ2_xAPpOPjmRrg" }, "name": { "type": "string", "example": "Tiffany J." }, "location": { "type": "string", "example": "Houston, TX" }, "total_reviews": { "type": "integer", "example": 1069 }, "friend_count": { "type": "integer", "example": 571 }, "avatar_url": { "type": "string", "example": "https://s3-media0.fl.yelpcdn.com/photo/X0InG8O9apnMdynq261XGg/ms.jpg" } } }, "owner_reply": { "type": "string", "description": "Optional field (nullable)" } } } } } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string", "example": "999de78a-7f68-45a3-8bd4-ffb78a776e1b" }, "endpoint": { "type": "string", "example": "/v1/yelp/reviews" }, "items_returned": { "type": "integer", "example": 20 }, "credits_charged": { "type": "integer", "example": 40 }, "cached": { "type": "boolean", "example": true }, "took_ms": { "type": "integer", "example": 0 } } } } }, "V1TripadvisorSearchResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "platform": { "type": "string", "example": "tripadvisor" }, "query": { "type": "string", "example": "Paris" }, "locations": { "type": "array", "items": { "type": "object", "properties": { "location_id": { "type": "string", "example": "187147" }, "geo_id": { "type": "string", "example": "187147" }, "result_type": { "type": "string", "example": "geos" }, "name": { "type": "string", "example": "Paris" }, "location_string": { "type": "string", "example": "Paris, Ile-de-France" }, "rating": { "type": "string", "description": "Optional field (nullable)" }, "review_count": { "type": "integer", "example": 5645698 }, "timezone": { "type": "string", "example": "Europe/Paris" }, "coordinates": { "type": "object", "properties": { "latitude": { "type": "number", "example": 48.857037 }, "longitude": { "type": "number", "example": 2.349401 } } }, "photo_url": { "type": "string", "example": "https://media-cdn.tripadvisor.com/media/photo-s/17/15/6d/d6/paris.jpg" } } } } } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string", "example": "7ff97937-3631-4e67-a80a-fb442a4cfa85" }, "endpoint": { "type": "string", "example": "/v1/tripadvisor/search" }, "items_returned": { "type": "integer", "example": 20 }, "credits_charged": { "type": "integer", "example": 100 }, "cached": { "type": "boolean", "example": true }, "took_ms": { "type": "integer", "example": 1 } } } } }, "V1TripadvisorRestaurantsResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "platform": { "type": "string", "example": "tripadvisor" }, "geo_id": { "type": "string", "example": "187147" }, "restaurants": { "type": "array", "items": { "type": "object", "properties": { "location_id": { "type": "string", "example": "14039269" }, "geo_id": { "type": "string", "example": "187147" }, "name": { "type": "string", "example": "Can Alegria Paris" }, "rating": { "type": "number", "example": 4.8 }, "review_count": { "type": "integer", "example": 1647 }, "popularity_rank": { "type": "integer", "example": 117 }, "price_range": { "type": "string", "example": "$$ - $$$" }, "cuisines": { "type": "array", "items": { "type": "string", "example": "French" } }, "neighborhood": { "type": "string", "example": "Saint-Georges" }, "travellers_choice_badge": { "type": "string", "example": "TRAVELLER_CHOICE 2026" }, "tripadvisor_url": { "type": "string", "example": "https://www.tripadvisor.com/Restaurant_Review-g187147-d14039269" } } } } } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string", "example": "a44353f9-f188-454c-9a44-9ac3fbf08069" }, "endpoint": { "type": "string", "example": "/v1/tripadvisor/restaurants" }, "items_returned": { "type": "integer", "example": 20 }, "credits_charged": { "type": "integer", "example": 100 }, "cached": { "type": "boolean", "example": true }, "took_ms": { "type": "integer", "example": 1 } } } } }, "V1GooglePlayReviewsResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "platform": { "type": "string", "example": "google_play" }, "app_id": { "type": "string", "example": "com.spotify.music" }, "country": { "type": "string", "example": "us" }, "lang": { "type": "string", "example": "en" }, "sentiment_summary": { "type": "object", "properties": { "sampled_reviews": { "type": "integer", "example": 20 }, "average_rating": { "type": "number", "example": 3.5 }, "star_distribution": { "type": "object", "properties": { "1": { "type": "integer", "example": 6 }, "2": { "type": "integer", "example": 0 }, "3": { "type": "integer", "example": 2 }, "4": { "type": "integer", "example": 2 }, "5": { "type": "integer", "example": 10 } } }, "star_percentages": { "type": "object", "properties": { "1": { "type": "integer", "example": 30 }, "2": { "type": "integer", "example": 0 }, "3": { "type": "integer", "example": 10 }, "4": { "type": "integer", "example": 10 }, "5": { "type": "integer", "example": 50 } } }, "sentiment_breakdown": { "type": "object", "properties": { "positive_pct": { "type": "integer", "example": 60 }, "neutral_pct": { "type": "integer", "example": 10 }, "negative_pct": { "type": "integer", "example": 30 }, "net_polarity_score": { "type": "number", "example": 0.24 } } }, "aspect_polarities": { "type": "array", "items": { "type": "object", "properties": { "aspect": { "type": "string", "example": "Ease of Use & UX" }, "polarity": { "type": "string", "example": "positive" }, "positive_pct": { "type": "integer", "example": 67 }, "mentions": { "type": "integer", "example": 6 } } } } } }, "reviews": { "type": "array", "items": { "type": "object", "properties": { "review_id": { "type": "string", "example": "9b85aa9d-ebba-4ab4-9a01-8a3405d9421d" }, "platform": { "type": "string", "example": "google_play" }, "app_id": { "type": "string", "example": "com.spotify.music" }, "rating": { "type": "integer", "example": 4 }, "review_text": { "type": "string", "example": "👍" }, "thumbs_up_count": { "type": "integer", "example": 0 }, "app_version": { "type": "string", "example": "9.1.92.3058" }, "published_at": { "type": "string", "example": "2026-11-13T17:32:14.000Z" }, "sentiment": { "type": "string", "example": "positive" }, "polarity_score": { "type": "number", "example": 0.5 }, "author": { "type": "object", "properties": { "id": { "type": "string", "example": "102329741725494484696" }, "name": { "type": "string", "example": "ABACAR abubacar Molide" }, "avatar_url": { "type": "string", "example": "https://play-lh.googleusercontent.com/a-/ALV-UjUFi9NHaWXcKjbYFsAs4j3JbJ6ECqzUz5G" } } }, "developer_reply": { "type": "string", "description": "Optional field (nullable)" } } } }, "next_cursor": { "type": "string", "example": "Cs4BIsUBARqIumh6GI49EPhr1UOeDEV-OAi2I_e_4A4_vJFRjCzlXgku0IN3RagNW-uaxlkYEvf1pcqh" } } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string", "example": "6297fbd8-5738-4c14-a071-aa8afc15aa75" }, "endpoint": { "type": "string", "example": "/v1/google-play/reviews" }, "items_returned": { "type": "integer", "example": 20 }, "credits_charged": { "type": "integer", "example": 40 }, "cached": { "type": "boolean", "example": false }, "took_ms": { "type": "integer", "example": 130 } } } } }, "V1AppStoreReviewsResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "platform": { "type": "string", "example": "app_store" }, "app_id": { "type": "string", "example": "324684580" }, "country": { "type": "string", "example": "us" }, "page": { "type": "integer", "example": 1 }, "sentiment_summary": { "type": "object", "properties": { "sampled_reviews": { "type": "integer", "example": 20 }, "average_rating": { "type": "number", "example": 3.6 }, "star_distribution": { "type": "object", "properties": { "1": { "type": "integer", "example": 4 }, "2": { "type": "integer", "example": 3 }, "3": { "type": "integer", "example": 1 }, "4": { "type": "integer", "example": 1 }, "5": { "type": "integer", "example": 11 } } }, "star_percentages": { "type": "object", "properties": { "1": { "type": "integer", "example": 20 }, "2": { "type": "integer", "example": 15 }, "3": { "type": "integer", "example": 5 }, "4": { "type": "integer", "example": 5 }, "5": { "type": "integer", "example": 55 } } }, "sentiment_breakdown": { "type": "object", "properties": { "positive_pct": { "type": "integer", "example": 60 }, "neutral_pct": { "type": "integer", "example": 5 }, "negative_pct": { "type": "integer", "example": 35 }, "net_polarity_score": { "type": "number", "example": 0.29 } } }, "aspect_polarities": { "type": "array", "items": { "type": "object", "properties": { "aspect": { "type": "string", "example": "Pricing & Billing" }, "polarity": { "type": "string", "example": "negative" }, "positive_pct": { "type": "integer", "example": 33 }, "mentions": { "type": "integer", "example": 6 } } } } } }, "reviews": { "type": "array", "items": { "type": "object", "properties": { "review_id": { "type": "string", "example": "14785065897" }, "platform": { "type": "string", "example": "app_store" }, "app_id": { "type": "string", "example": "324684580" }, "country": { "type": "string", "example": "us" }, "rating": { "type": "integer", "example": 5 }, "title": { "type": "string", "example": "Meow" }, "review_text": { "type": "string", "example": "I have premium so it’s actually useable 😭 but I really like Spotify because I ca" }, "app_version": { "type": "string", "example": "9.1.98" }, "vote_sum": { "type": "integer", "example": 0 }, "vote_count": { "type": "integer", "example": 0 }, "published_at": { "type": "string", "example": "2026-11-13T03:59:05-07:00" }, "sentiment": { "type": "string", "example": "positive" }, "polarity_score": { "type": "number", "example": 0.85 }, "author": { "type": "object", "properties": { "name": { "type": "string", "example": "The real Miku ✌️" }, "profile_url": { "type": "string", "example": "https://itunes.apple.com/us/reviews/id1901157728" } } } } } } } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string", "example": "14c5188d-1dd1-4fc0-a37f-58b3531a8325" }, "endpoint": { "type": "string", "example": "/v1/app-store/reviews" }, "items_returned": { "type": "integer", "example": 20 }, "credits_charged": { "type": "integer", "example": 40 }, "cached": { "type": "boolean", "example": true }, "took_ms": { "type": "integer", "example": 0 } } } } }, "V1GlassdoorCompaniesResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "platform": { "type": "string", "example": "glassdoor" }, "query": { "type": "string", "example": "Printful" }, "companies": { "type": "array", "items": { "type": "object", "properties": { "company_id": { "type": "string", "example": "1001330" }, "name": { "type": "string", "example": "Printful" }, "website": { "type": "string", "example": "https://www.printful.com" }, "rating": { "type": "number", "example": 4 }, "review_count": { "type": "integer", "example": 342 }, "salary_count": { "type": "integer", "example": 195 }, "job_count": { "type": "integer", "example": 38 }, "headquarters_location": { "type": "string", "example": "Charlotte, NC" }, "company_size": { "type": "string", "example": "1001 to 5000 Employees" }, "industry": { "type": "string", "example": "Internet & Web Services" }, "ceo": { "type": "string", "example": "Alex Saltonstall" }, "ceo_approval_rate": { "type": "number", "example": 0.82 }, "recommend_to_friend_rate": { "type": "number", "example": 0.78 }, "sub_ratings": { "type": "object" } } } } } }, "meta": { "type": "object" } } }, "V1GlassdoorReviewsResponse": { "type": "object", "properties": { "code": { "type": "integer", "example": 0 }, "provider": { "type": "string", "example": "https://reviewsdataapi.com" }, "status": { "type": "string", "example": "ok" }, "msg": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "platform": { "type": "string", "example": "glassdoor" }, "company_id": { "type": "string", "example": "1001330" }, "sentiment_summary": { "type": "object" }, "reviews": { "type": "array", "items": { "type": "object", "properties": { "review_id": { "type": "string", "example": "89412018" }, "platform": { "type": "string", "example": "glassdoor" }, "company_id": { "type": "string", "example": "1001330" }, "rating": { "type": "number", "example": 5 }, "title": { "type": "string" }, "pros": { "type": "string" }, "cons": { "type": "string" }, "advice_to_management": { "type": "string", "nullable": true }, "job_title": { "type": "string", "nullable": true }, "employment_status": { "type": "string", "nullable": true }, "is_current_employee": { "type": "boolean", "nullable": true }, "location": { "type": "string", "nullable": true }, "helpful_count": { "type": "integer" }, "published_at": { "type": "string", "nullable": true }, "sub_ratings": { "type": "object" }, "sentiment": { "type": "string", "example": "positive" }, "polarity_score": { "type": "number", "example": 0.93 } } } }, "pagination": { "type": "object" } } }, "meta": { "type": "object" } } } } } }