Naar de hoofdinhoud

Hoe Google-reviews aan je Next.js-website toe te voegen

Plaats Google-reviews op je Next.js-site met een servercomponent en handige code-prompt voor je AI-coderingsagent.

A
Geschreven door Axel Lavergne

De beste manier om Google-reviews op een Next.js-site weer te geven, is door ze via een review-API vanuit een servercomponent op te halen en Next.js ze elke uur te laten vernieuwen. De reviews worden in de HTML geladen, zodat de pagina snel blijft, zoekmachines ze kunnen indexeren en je API-sleutel niet in de browser terechtkomt. Als je site is gebouwd met v0 by Vercel, is dit ook voor jou van toepassing. Aan het einde staat de code en een prompt die je aan je AI-coderingsagent kan geven. Maak bewust keuzes voor je de code plakt, want die beïnvloeden hoe goed het werkt.

TLDR

  • De beste manier om Google-reviews op een Next.js-site te tonen is ze via een review-API in een servercomponent op te halen, zodat de reviews in de HTML aankomen en je API-sleutel nooit de browser bereikt.

  • De Reviewflowz API haalt je Google-reviews op zonder toegang tot Google Business Profile en zonder goedkeuring van Google, en dezelfde API levert reviews van 200+ platforms in dezelfde velden.

  • Een Reviewflowz-reviewwidget is één iframe dat je vrij aanpast, zodat je altijd actuele Google-reviews toont op een Next.js-site zonder ophaalcode te schrijven.

  • Met de tags van Reviewflowz vraagt elke pagina van je site alleen de reviews op die erbij passen, of je reviews nu met de hand taggt of door AI laat taggen.

Wanneer de reviews ophalen: bij build, bij paginalading of in een iframe

Er zijn drie momenten om reviews toe te voegen op een pagina, en elk heeft zijn eigen balans tussen snelheid, actualiteit en indexeerbaarheid.

Optie

Hoe het werkt

De afweging

Bij build

De server haalt de reviews op en zet deze in de HTML.

De snelste, meest efficiënte methode. Reviews zijn zo actueel als je laatste update, dus plan wanneer ze vernieuwen.

Async bij paginalading

Een script laadt de reviews nadat de pagina is geladen.

Dit kan wijzigen hoe de pagina wordt geïndexeerd en gelezen.

Iframe bij paginalading

De pagina embed een reviewwidget in een iframe.

Een goede compromis: altijd actueel, blijft snel doordat de widget statisch laadt.

Met een servercomponent in Next.js heb je de eerste optie zonder extra builds. Dit draait op de server, zorgt ervoor dat reviews in de HTML staan en de sleutel niet in de browserkomt. revalidate laat Next.js ze elke uur vernieuwen.

Het iframe, zonder te bouwen. De Reviewflowz-reviewwidget is een iframe dat je zelf kunt aanpassen. Wij zorgen dat het actueel en supersnel blijft door het statisch te laden. Je vindt het onder Integraties, op het Widgets-tabblad.

Waar de reviews vandaan komen: Places API, Business Profile API, of een review-API

Welke bron je kiest bepaalt hoeveel reviews je kunt laten zien en hoeveel opzet er nodig is.

Bron

Wat je krijgt

Wat het kost

Google Places API

5 reviews, een willekeurige steekproef. Ze kunnen oud zijn of negatief.

Een Google Cloud API-sleutel.

Google Business Profile API

Alle reviews van je eigen profiel.

Eerst goedkeuring: je vraagt toegang aan en Google beoordeelt binnen 14 dagen. Daarna OAuth met toegang als eigenaar of manager van het profiel.

Externe review-API

Alle reviews en ook die van andere platformen.

Een API-sleutel. Geen toegang tot Business Profile nodig.

Met slechts vijf reviews kom je niet ver. Daarom heb je in de praktijk toegang nodig tot Business Profile, na goedkeuring door Google, of je gebruikt een dienst die dat regelt.

Geen toegang tot Business Profile nodig. De Reviewflowz API haalt je Google-reviews op zonder toegang tot Business Profile en zonder goedkeuring van Google, en dezelfde API dekt 200+ platforms in vergelijkbare velden. Hier is de output voor Google.

Welke reviews te tonen

Elke review tonen lijkt makkelijk maar is zelden de beste keuze. Bedenk deze zaken voordat je begint met coderen:

  • Alle reviews of een selectie?

  • Handmatig geselecteerd of automatisch?

  • Met regels: een minimum score, tekst vereist, nieuwste eerst?

  • Gefilterd op onderwerp, locatie, taal, of passend bij de pagina?

De volgende code selecteert automatisch, met regels: 6 reviews, 5 sterren, met geschreven tekst, nog steeds op Google, nieuwste eerst. Elke regel is gemakkelijk aan te passen. Drie extra filters zijn beschikbaar: language=en voor één taal, location=<id> voor een specifieke locatie, en tag=<id> voor handmatig of met AI geselecteerde reviews.

Selecteer reviews per pagina met tags. In Reviewflowz geef je reviews tags, of laat AI dit doen, en elke pagina vraagt de API om de reviews met die tag. Lugg bouwde zijn reviewpagina zo: bezoekers kiezen een use-case en stad en lezen precies daarover, en 6 tot 9% van de nieuwe gebruikers landt eerst op een reviewpagina. Lees de testimonial feeds gids voor meer info.

Reviews van Tripadvisor, Trustpilot en andere platforms

Wil je meer dan alleen Google-reviews, dan heb je een externe review-API nodig. Sommige platforms, zoals Tripadvisor, verbieden het gebruik van je eigen reviews op je website. In de praktijk maakt het de meeste mensen niet uit. Het is gebruikelijk om te linken naar de originele review, zodat die platforms geen klachten hebben.

De volgende code doet dit voor Google: elke review bevat een url die de review op Google opent, en de component toont dit als een "Lees op Google"-link, zodat bezoekers de echtheid kunnen controleren.

Andere platforms, dezelfde werkwijze. Met Reviewflowz krijg je ook toegang tot Tripadvisor, Trustpilot, en anderen met dezelfde oproep: wijzig platform en de reviews komen terug in dezelfde dataset, elk met een eigen url om naar terug te linken. Lees de testimonial feeds gids voor alle filters.

Google-reviews aan je Next.js-site toevoegen, stap voor stap

Stap 1. Ga in Reviewflowz naar Review Sources en klik op Nieuwe reviewbron. Kies Google Maps, zoek je bedrijf op en selecteer dit.

De pagina voor nieuwe reviewbron met Google Maps geselecteerd en een bedrijf gevonden op naam

Stap 2. Ga naar Instellingen → Webhooks & API en klik op Maak een API-sleutel aan. Geef het een naam, kies Alleen lezen en genereer de sleutel. De API is onderdeel van het Premium-abonnement.

Het API-sleutelvenster met Alleen lezen toestemming geselecteerd.

Stap 3. Zet de sleutel in .env.local als REVIEWFLOWZ_KEY, en voeg dezelfde variabele toe aan de omgevingsvariabelen van je host (bij Vercel, in de projectinstellingen). Stap 4. Maak app/components/GoogleReviews.tsx en plak de volgende code:

// app/components/GoogleReviews.tsx
// Een servercomponent: hij draait op de server, zodat je sleutel nooit in de browser terechtkomt. Zet REVIEWFLOWZ_KEY=rfz_live_... in .env.local (en in omgevingsvariabelen van je host, zoals bij Vercel).

type Review = {
id: string;
rating: number;
text: string | null;
reviewer: { name: string | null };
url: string | null;
};

export default async function GoogleReviews() {
const params = new URLSearchParams({
platform: "google_maps", // Alleen Google-reviews
rating_min: "5", // 5 sterren
has_text: "true", // met geschreven tekst
removed: "false", // nog live op Google
sort: "date", // nieuwste eerst
limit: "6", // hoeveel je wilt tonen
});

const res = await fetch(`https://api.reviewflowz.com/v3/reviews?${params}`, {
headers: { Authorization: `Bearer ${process.env.REVIEWFLOWZ_KEY}` },
next: { revalidate: 3600 }, // maximaal elk uur vernieuwen
});
if (!res.ok) throw new Error(`Reviewflowz API ${res.status}: ${await res.text()}`);
const { data: reviews }: { data: Review[] } = await res.json();

return (
<section className="google-reviews">
{reviews.map((review) => (
<figure key={review.id}>
<p aria-label={`${review.rating} out of 5 stars`}>{"★".repeat(Math.round(review.rating))}</p>
<blockquote>{review.text}</blockquote>
<figcaption>
{review.reviewer.name}
{review.url && <a href={review.url} target="_blank" rel="noopener">Lees op Google</a>}
</figcaption>
</figure>
))}
</section>
);
}

Stap 5. Importeer de component op elke gewenste pagina en zet <GoogleReviews /> daar waar je de reviews wilt laten zien. Stap 6. Gebruik revalidate: 3600 voor de versheid van reviews: maximaal elk uur vernieuwen. De API geeft een ETag en een 304-antwoord telt meet als een oproep, met een limiet van 300 oproepen per minuut per account.

Prompt voor je AI-coderingsagent: Voeg een Google-reviewsectie toe aan deze Next.js-site. Maak app/components/GoogleReviews.tsx als een servercomponent die GET https://api.reviewflowz.com/v3/reviews?platform=google_maps&rating_min=5&has_text=true&removed=false&sort=date&limit=6 met de header "Authorization: Bearer" plus de REVIEWFLOWZ_KEY omgevingsvariabele, en next: { revalidate: 3600 } ophaalt. Zorg dat het een servercomponent blijft, zodat de sleutel nooit de browser bereikt. Toon de beoordeling, tekst, naam van de recensent en een "Lees op Google"-link naar zijn url voor elke review. Volg de checklist op https://api.reviewflowz.com/v3/docs/guides/testimonial-feeds.

Wil je elke optie, filter en webhook op één plek? Bekijk Bouw een testimonial feed voor elke pagina. Ben je een WordPress-gebruiker? Embed een reviewwidget op WordPress.

Was dit een antwoord op uw vraag?