docs / reclameaqui

Reclame Aqui

Brazilian company complaints and reputation.

base /reclameaqui/v16 endpoints

post/reclameaqui/v1/company/search1 credit

resolve a company by name/slug

Parameter		Allowed / range	Description
query	optional	—	Company name (resolved to a slug) or, for complaints/search, the keyword to match in complaint titles/bodies.
slug	optional	—	ReclameAqui company shortname/slug (e.g. 'nubank'). Provide this OR query / company_id.

Try in playground →

post/reclameaqui/v1/company/detail1 credit

company profile + reputation index

Parameter		Allowed / range	Description
slug	optional	—	ReclameAqui company shortname/slug (e.g. 'nubank'). Provide this OR query / company_id.
company_id	optional	—	ReclameAqui numeric company id (from company/detail or company/search).

Try in playground →

post/reclameaqui/v1/company/stats3 credits

reputation metrics + main/performance problems

Parameter		Allowed / range	Description
slug	optional	—	ReclameAqui company shortname/slug (e.g. 'nubank'). Provide this OR query / company_id.
company_id	optional	—	ReclameAqui numeric company id (from company/detail or company/search).

Try in playground →

post/reclameaqui/v1/company/complaints1 credit

paginated complaints for a company

Parameter		Allowed / range	Description
company_id	required	—	ReclameAqui numeric company id (from company/detail or company/search).
status = ANSWERED	optional	ANSWERED · EVALUATED · NOT_ANSWERED · PROCESSING	Complaint status to page through (default ANSWERED). Use `statuses` to combine several.
statuses	optional	—	Optional list of statuses to fetch (overrides `status`).
limit = 50	optional	1–255	Maximum complaints to return (public cap is 255).
page_size = 5	optional	1–50	Complaints fetched per upstream page (tuning knob).
date_from	optional	—	Only include complaints on/after this date (YYYY-MM-DD).
date_to	optional	—	Only include complaints on/before this date (YYYY-MM-DD).
company_slug	optional	—	Company slug (used to build the complaint URL / label rows).
company_name	optional	—	Optional company display name to stamp onto returned complaint rows.

Try in playground →

post/reclameaqui/v1/complaints/search1 credit

search complaints by keyword

Parameter		Allowed / range	Description
query	required	—	Company name (resolved to a slug) or, for complaints/search, the keyword to match in complaint titles/bodies.
limit = 50	optional	1–255	Maximum complaints to return (public cap is 255).
page_size = 10	optional	1–50	Complaints fetched per upstream page (tuning knob).
date_from	optional	—	Only include complaints on/after this date (YYYY-MM-DD).
date_to	optional	—	Only include complaints on/before this date (YYYY-MM-DD).

Try in playground →

post/reclameaqui/v1/complaint/detail2 credits

single complaint thread (HTML timeline)

Parameter		Allowed / range	Description
company_slug	required	—	Company slug (used to build the complaint URL / label rows).
complaint_url_slug	required	—	The complaint's URL slug (the last path segment of its ReclameAqui page).

Try in playground →

Example request · company/search

curl -X POST https://api.reefapi.com/reclameaqui/v1/company/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"nubank"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}