Dev.to WebDev πŸ›  Dev πŸ‘ 0 πŸ“– 5 min read

How to Build a Classified Website for Brazil

Short answer: A Brazilian classified site needs Portuguese (pt-BR) content, Pix and boleto payments, LGPD-compliant data handling, CEP-based location search, WhatsApp-first contact, and hosting close to SΓ£o Paulo. Get th

Short answer: A Brazilian classified site needs Portuguese (pt-BR) content, Pix and boleto payments, LGPD-compliant data handling, CEP-based location search, WhatsApp-first contact, and hosting close to SΓ£o Paulo. Get these right and the rest is a standard classifieds build.

Brazil has more than 200 million people, and most of them browse on a phone. OLX Brasil, Mercado Livre and Webmotors are big, so a general site will struggle. This guide shows the Brazil-specific things you need and how to start.

1. Pick a Niche and a City First

Don't launch "everything for everyone" nationwide. Brazil is huge, and buyers want listings near them.

  • Choose one category: cars, real estate, jobs, services or second-hand goods.
  • Launch in one city or state first, such as SΓ£o Paulo, Rio de Janeiro or Belo Horizonte.
  • Add more regions once each area has enough listings.

An empty marketplace loses visitors fast, so density matters more than coverage.

2. Localize Everything for pt-BR

Use Brazilian Portuguese, not European Portuguese. The vocabulary and tone differ.

Formats to get right:

  • Currency: R$ 1.234,56 (dot for thousands, comma for decimals)
  • Dates: dd/mm/yyyy
  • Phone numbers: +55 with a two-digit area code (DDD)

In JavaScript, the browser can format prices for you:

const price = new Intl.NumberFormat('pt-BR', {
  style: 'currency',
  currency: 'BRL'
}).format(1234.5);
// "R$ 1.234,50"

Store your text in i18n files from day one, even if you only have one language.

3. Support Brazilian Payment Methods

If you charge for featured ads, subscriptions or listing fees, cards alone won't work.

  • Pix: the instant bank transfer system run by the central bank. Almost everyone uses it. This is a must-have.
  • Boleto bancΓ‘rio: a printable or digital payment slip. Many people still prefer it.
  • Credit cards with installments (parcelamento): very common in Brazil.

Gateways such as Mercado Pago, PagSeguro, Pagar.me, Asaas and Stripe's Brazil product support these methods. Compare their fees and API docs before choosing.

4. Follow the Law (LGPD and Consumer Rules)

This part matters, so read it carefully. This is general information, not legal advice, so talk to a Brazilian lawyer before launch.

  • LGPD (Lei Geral de ProteΓ§Γ£o de Dados): Brazil's data protection law, similar in spirit to GDPR. You need a clear privacy policy, user consent, and a way for users to access or delete their data.
  • Marco Civil da Internet: sets rules for platform responsibility over user content. Court decisions in recent years have made platforms more responsible, so build a proper report-and-remove process.
  • Consumer Defense Code (CDC): applies if you sell services or take payments.
  • Invoices: if you charge fees, ask an accountant about issuing service invoices (NFS-e).
  • Prohibited items: write clear rules banning illegal goods, weapons and anything else your lawyer flags.

You will also need a Brazilian company number (CNPJ) for local payment accounts and for a .com.br domain.

5. Build Trust: Verification and Anti-Fraud

Scams are a big concern for Brazilian buyers, and trust is a real competitive advantage.

  • Phone verification: use an OTP (one-time password) through SMS or WhatsApp.
  • CPF validation: for sellers in high-risk categories, validate the CPF format (the national taxpayer ID). Handle it carefully under LGPD.
  • Seller profiles: show join date, number of ads and verified badges.
  • Report button: put it on every listing.
  • Moderation queue: review new ads manually at the beginning, and add automated checks later.

6. Make WhatsApp the Main Contact Channel

Brazilians use WhatsApp for almost everything. A form that emails the seller is not enough.

Add a "Chat on WhatsApp" button that opens a pre-filled message:

<a href="https://wa.me/5511999999999?text=Hi%2C%20I%20saw%20your%20ad">
  Chat on WhatsApp
</a>

Let sellers choose whether to show their number publicly, to reduce spam.

7. Use Brazilian Location Data

Location search is the heart of a classifieds site.

  • CEP: the Brazilian postal code. Let users search by CEP, and auto-fill the address with a free API like ViaCEP.
  • States and cities: Brazil has 26 states plus the Federal District, and more than 5,500 municipalities. IBGE (the official statistics institute) publishes the official list.
  • Neighborhoods (bairros): important for real estate and local services.

Add map-based search for cars and property, and store latitude and longitude for every ad.

8. Choose a Tech Stack That Fits

You have two main routes.

Build from scratch:

  • Backend: Laravel, Node.js or Django
  • Database: PostgreSQL or MySQL
  • Search: Meilisearch or Elasticsearch
  • Storage: S3-compatible bucket for images

Use a ready-made classified script and customize it for Brazil. This is faster, but check that it supports pt-BR, multiple currencies and local payment gateways before you buy.

Either way, make your search accent-insensitive. Users often type "imovel" instead of "imΓ³vel" or "sao paulo" instead of "SΓ£o Paulo", and your search should return the same results.

9. Host Close to Your Users

Speed affects both user experience and Google ranking.

  • Use a cloud region in SΓ£o Paulo, such as AWS sa-east-1, Google Cloud southamerica-east1 or Azure Brazil South.
  • Put a CDN in front of your images.
  • Compress and lazy-load photos, because many users are on mobile data.
  • Aim for a fast mobile page load with Core Web Vitals in the green.

10. Do SEO for Brazil

Most Brazilians search on Google, so SEO is your cheapest traffic source.

  • Use a .com.br domain, which signals local relevance.
  • Add hreflang="pt-BR" and set lang="pt-BR" on your pages.
  • Create clean URLs per category and city, like /carros/sao-paulo/.
  • Write unique titles and descriptions, for example "Carros usados em SΓ£o Paulo".
  • Add structured data (JSON-LD) for products, vehicles or real estate.
  • Submit your sitemap in Google Search Console.
  • Create a Google Business Profile if you have a local presence.

11. Launch Checklist

  • [ ] pt-BR interface and formats
  • [ ] Pix, boleto and card payments
  • [ ] Privacy policy and terms in Portuguese
  • [ ] Phone verification and report button
  • [ ] WhatsApp contact button
  • [ ] CEP and city search
  • [ ] SΓ£o Paulo hosting and CDN
  • [ ] Sitemap and Search Console
  • [ ] 100 to 200 seed listings in your first city

Frequently Asked Questions

Do I need a company in Brazil?
For local payment accounts and a .com.br domain, usually yes, since a CNPJ is typically required. Confirm with an accountant.

Is a mobile app necessary at the start?
No. A fast, mobile-friendly website comes first. Add an app once you have steady traffic.

How do I get my first listings?
Contact local sellers directly, offer free listings for the first few months, and import listings with their permission.

How much does it cost?
It depends on your route. A ready-made script is cheaper upfront, while a custom build costs more but gives full control.

Final Thoughts

Building a classified site for Brazil is mostly about local details: language, Pix, WhatsApp, LGPD and local search. Start small, pick one niche and one city, earn trust, and expand from there.

Have you built a marketplace for a specific country? Share your tips in the comments.

πŸ“° Read the original article on Dev.to WebDev

Originally published by Dev.to WebDev. Aggregated on AIWithGhost for educational purposes β€” full credit and traffic to the original publisher.