{"uid":"cap_TxWJeUlqAQ_vzhqYATR1y","slug":"agents-litescrape-com-get-google-maps-contributor-review-history-fd31c8c7","name":"Get Google Maps Contributor Review History","description":"Returns up to 200 reviews written by one Google Maps contributor: contributor (name and profile details), search_information, and reviews, each with the place reviewed (place_info), rating, snippet, and date. Identify the contributor by the numeric ID in their Google Maps contributor URL. Allow up to 120 seconds for a response. One call is one request.","url":"https://agents.litescrape.com/api/google/contributor-reviews","method":"GET","headers":{},"bodySchema":{"type":"object","required":["contributor_id"],"properties":{"gl":{"type":"string","default":"us","maxLength":2,"minLength":2,"description":"Two-letter country code."},"hl":{"type":"string","default":"en","description":"Review and interface language, such as en, en-US, or fr."},"limit":{"type":"integer","default":200,"maximum":200,"minimum":1,"description":"Number of reviews to return."},"contributor_id":{"type":"string","pattern":"^[0-9]{10,32}$","description":"10 to 32 digit ID from a Google Maps contributor URL."}}},"responseSchema":{"type":"object","properties":{"reviews":{"type":"array","items":{"type":"object"},"description":"Reviews with place_info, rating, snippet, date."},"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"contributor":{"type":"object","description":"The contributor: name and profile details."},"search_metadata":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"total_time_taken":{"type":"number"}}},"search_parameters":{"type":"object","description":"The request parameters as normalized by the API."},"search_information":{"type":"object","description":"Counts and paging details."}},"description":"Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000150","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.000150/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__Brzja_x10y7Vqb2td49U","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000150","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.litescrape.com","brandSlug":"agents-litescrape-com-mpp","brandBaseUrl":"https://agents.litescrape.com","brandDocsUrl":null,"whatItDoes":"Returns up to 200 reviews written by a specific Google Maps contributor, including their profile, rated places, snippets, and review dates.","exampleAgentPrompt":"Pull the full review history for Google Maps contributor 102750482817786558541 — give me their profile details and all reviews with place names, ratings, and dates in English.","exampleUseCases":[{"title":"Profile a prolific local guide","prompt":"Get me all the reviews written by Google Maps contributor 112345678901234567890 — I want their profile info, every place they've reviewed, the star rating they gave, and the review text."},{"title":"Monitor a competitor's reviewer network","prompt":"Fetch the review history for Google Maps user 987654321098765432 in French so I can see what restaurants they've rated and what they said about each one."},{"title":"Build a reviewer trust score dataset","prompt":"I need the last 50 reviews from Google Maps contributor 100112233445566778899 to analyze their rating patterns — get me the place details, ratings, and dates for each review."}],"resultDescription":"Returns a JSON object containing: contributor (name and profile details), reviews array (each with place_info including place name and address, rating out of 5, review snippet text, and date), search_information (counts and paging details), search_parameters (normalized request params), search_metadata (request ID, status, time taken), and an optional pagination object with a next-page URL or token when more than the requested limit of reviews exist.","failureModes":["Invalid contributor_id format (not 10-32 digits) returns 400 with error_code and search_parameters echoed","Contributor not found or profile is private returns empty reviews array","Timeout after 120 seconds if Google Maps is slow to respond","Rate limiting or upstream Google blocking returns a retryable error with retryable=true","Invalid country code (gl) or language code (hl) may return default-language results or a 400 error"],"whenToPreferThis":"Use this endpoint when you need structured, paginated review data for a known Google Maps contributor identified by their numeric profile ID. It is the right choice for profiling reviewers, auditing local guides, building datasets of user-generated place reviews, or monitoring a specific contributor's activity over time. Prefer it over general Google Maps search endpoints when the subject is a person/contributor rather than a place or business.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T17:29:31.785Z","isFirstParty":false}