---
title: "Advertiser Listings"
method: GET
path: "/vivareal/advertiser-listings"
tags: ["VivaReal"]
---

# Advertiser Listings

`GET /vivareal/advertiser-listings`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/vivareal/advertiser-listings`
- Auth: API key in header `X-API-KEY`

Live stock of one advertiser, paged like the search endpoint.

## Query parameters

- `portal` 'ZAP' | 'VIVAREAL' | 'zap' | 'vivareal'
- `advertiser_id` string, required
- `business` 'RENTAL' | 'SALE' | 'rental' | 'sale'
- `rows` integer
- `page` integer

## Response `200`

- union
  - string
  - object
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'validation_failed', required
      - `message` 'advertiser_id is required.', required
    - `meta` unknown[], required
      - unknown

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/31329f110e7c?raw)