> ## Documentation Index > Fetch the complete documentation index at: https://api.housera.ro/llms.txt > Use this file to discover all available pages before exploring further. # Cum merg anunțurile > Cifrele din prima pagină a contului: vizualizările, salvările și contactele pe fiecare zi, pe 7, 30 sau 90 de zile, plus totalurile perioadei de dinainte, ca să le poți compara. Cheia unui cont fără echipă primește anunțurile contului. Cheia titularului, a unui administrator sau a unui manager primește anunțurile echipei pe care o vede în portal și poate filtra pe un coleg cu `agent`. Momentele graficului și sursele contactelor vin doar dacă cheia are și `leads:read`. ## OpenAPI ````yaml ro/openapi.json GET /account/stats openapi: 3.1.2 info: title: Housera API version: 1.0.0 description: >- Publică și gestionează anunțuri imobiliare pe Housera din CRM-ul sau din aplicația ta, cu aceleași reguli ca formularul din portalul Housera. servers: - url: https://staging.housera.ro/api/v1 description: 'Sandbox (staging): date de test, aceleași reguli ca producția.' - url: https://housera.ro/api/v1 description: 'Producție: anunțurile reale de pe housera.ro.' security: - bearer: [] tags: - name: Anunțurile tale - name: Poze - name: Evenimente - name: Vocabular - name: Conectează cu Housera - name: Cererile clienților - name: Firma și echipa - name: Mandatele de comercializare - name: Vizionări - name: Proiecte - name: Parteneriate - name: Cheia API - name: Statistici paths: /account/stats: get: tags: - Statistici summary: Cum merg anunțurile description: >- Cifrele din prima pagină a contului: vizualizările, salvările și contactele pe fiecare zi, pe 7, 30 sau 90 de zile, plus totalurile perioadei de dinainte, ca să le poți compara. Cheia unui cont fără echipă primește anunțurile contului. Cheia titularului, a unui administrator sau a unui manager primește anunțurile echipei pe care o vede în portal și poate filtra pe un coleg cu `agent`. Momentele graficului și sursele contactelor vin doar dacă cheia are și `leads:read`. operationId: v1.stats.account parameters: - name: range in: query schema: type: - integer - 'null' enum: - '7' - '30' - '90' - null description: 'Perioada, în zile: `7`, `30` (implicit) sau `90`.' - name: agent in: query schema: type: - string - 'null' format: email maxLength: 254 description: >- Emailul unui coleg din echipa ta: primești doar cifrele anunțurilor lui. Merge doar cu cheia titularului, a unui administrator sau a unui manager. - name: locale in: query required: false schema: type: string enum: - ro - en default: ro example: ro description: >- Limba răspunsului, `ro` sau `en`. Schimbă mesajele erorilor (`title`, `detail`), etichetele și, când anunțul are o traducere aprobată în limba cerută, titlul și descrierea lui. Codurile sunt aceleași în orice limbă. Are întâietate față de `Accept-Language` și de limba contului. responses: '200': content: application/json: schema: type: object properties: data: type: object properties: range: type: integer description: Perioada, în zile. scope: type: string enum: - team - account description: >- `account` pentru anunțurile contului, `team` pentru anunțurile echipei pe care o vede contul. agent: type: - string - 'null' description: Emailul colegului după care ai filtrat, altfel `null`. timezone: type: string description: Fusul orar în care se numără zilele. days: type: array items: {} description: Zilele perioadei, de la cea mai veche. totals: type: object properties: views: type: number description: Vizualizările. saves: type: number description: Salvările la favorite. contacts: type: number description: Contactele venite prin anunțuri. required: - views - saves - contacts description: Totalurile perioadei. previous: type: object properties: views: type: number description: Vizualizările. saves: type: number description: Salvările la favorite. contacts: type: number description: Contactele venite prin anunțuri. required: - views - saves - contacts description: Totalurile perioadei de dinainte, de aceeași lungime. top: type: array items: {} description: >- Cele mai văzute cinci anunțuri ale perioadei sau, pentru echipă, colegii cu cele mai multe vizualizări. moments: type: - array - 'null' items: {} description: >- Ce explică graficul: un anunț publicat (`published`), dezactivat (`deactivated`), reactivat (`reactivated`) sau vândut (`sold`) în perioadă. Vine doar cu `leads:read`, altfel e `null`. contacts: type: - object - 'null' properties: sources: type: array items: {} description: Pe ce cale au venit contactele. new: type: integer description: Câte contacte n-au primit încă răspuns. in_progress: type: integer description: Câte contacte sunt în lucru. required: - sources - new - in_progress description: >- Contactele perioadei venite prin anunțuri. Vine doar cu `leads:read`, altfel e `null`. required: - range - scope - agent - timezone - days - totals - previous - top - moments - contacts description: Rezultatul cererii. required: - data description: Cererea a reușit. '401': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: Cheia lipsește, e revocată sau a expirat (`unauthenticated`). '403': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: >- Cheia nu are dreptul cerut (`missing_ability`) sau accesul e refuzat (`forbidden`). '422': content: application/problem+json: schema: $ref: '#/components/schemas/ValidationProblem' description: >- `range` nu e 7, 30 sau 90, ori `agent` nu e emailul unui coleg din echipa ta (`agent_not_member`). O cheie fără echipă care trimite `agent` primește `agent_not_allowed`. '429': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: >- Prea multe cereri. Reîncearcă după numărul de secunde din `Retry-After`. components: schemas: Problem: type: object title: Problem properties: type: type: string format: uri description: Adresa tipului de problemă (RFC 9457). title: type: string description: Rezumatul problemei, în limba cererii. status: type: integer description: Codul HTTP. code: type: string description: >- Codul stabil al refuzului, după care tratezi eroarea (lista e în pagina Erori). detail: type: string description: Explicația, în limba cererii. existing: type: object properties: code: type: string description: Codul public al anunțului existent. external_ref: type: - string - 'null' description: >- Id-ul tău pentru anunțul existent, dacă l-ai pus tu cu `PUT /listings/ref/{ref}`. Altfel `null`. required: - code - external_ref description: >- Doar la `409 duplicate_listing`: anunțul pe care îl ai deja pentru aceeași proprietate. required: - type - title - status - code - detail ValidationProblem: type: object title: ValidationProblem properties: type: type: string format: uri description: Adresa tipului de problemă (RFC 9457). title: type: string description: Rezumatul problemei, în limba cererii. status: type: integer description: 'Codul HTTP: `422`.' errors: type: array items: type: object properties: pointer: type: string description: Câmpul la care se referă, ca JSON Pointer (`/features/2`). code: type: string description: Regula încălcată, ca cod stabil (lista e în pagina Erori). detail: type: string description: >- Explicația, în limba cererii. Textul se poate schimba, așa că tratezi eroarea după `code`. required: - pointer - code - detail description: Câte o intrare pentru fiecare câmp care nu trece regulile. required: - type - title - status - errors securitySchemes: bearer: type: http scheme: bearer description: 'Authorization: Bearer ' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.