> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Markets

> List all supported realtor markets with their portals, currencies, and locales.

## Response

<ResponseField name="markets" type="array">
  Array of supported markets.

  <Expandable title="Market object">
    <ResponseField name="code" type="string">Market code to use in the `market` query parameter (`us` or `ca`).</ResponseField>
    <ResponseField name="domain" type="string">Portal domain (`realtor.com` or `realtor.ca`).</ResponseField>
    <ResponseField name="country" type="string">ISO 3166-1 alpha-2 country code.</ResponseField>
    <ResponseField name="currency" type="string">ISO 4217 currency code used in this market.</ResponseField>
    <ResponseField name="locale" type="string">BCP-47 locale (e.g. `en-US`).</ResponseField>
    <ResponseField name="name" type="string">Market country name.</ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json theme={null}
{
  "markets": [
    { "code": "us", "domain": "realtor.com", "country": "US", "currency": "USD", "locale": "en-US", "name": "United States" },
    { "code": "ca", "domain": "realtor.ca", "country": "CA", "currency": "CAD", "locale": "en-CA", "name": "Canada" }
  ]
}
```

<Note>
  Listing markets is a **free** reference endpoint (0 credits).
</Note>


## OpenAPI

````yaml GET /v1/realtor/markets
openapi: 3.1.0
info:
  title: ScrapeBadger Realtor API
  version: 1.0.0
  description: >-
    Unified real-estate scraping API over realtor.com (US) and realtor.ca
    (Canada) for searching listings, fetching full property detail (price/tax
    history, schools, agents, estimates), location autocomplete, and reference
    data.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/realtor/markets:
    get:
      tags:
        - Realtor Reference
      summary: List Markets
      description: List all supported realtor markets.
      operationId: listRealtorMarkets
      parameters: []
      responses:
        '200':
          description: Supported markets
          content:
            application/json:
              schema:
                type: object
                properties:
                  markets:
                    type: array
                    items:
                      $ref: '#/components/schemas/Market'
components:
  schemas:
    Market:
      type: object
      properties:
        code:
          type: string
          description: Market code for the `market` query parameter (us or ca).
        domain:
          type: string
          description: Portal domain (realtor.com or realtor.ca).
        country:
          type: string
          description: ISO 3166-1 alpha-2 country code.
        currency:
          type: string
          description: ISO 4217 currency code.
        locale:
          type: string
          description: BCP-47 locale (e.g. en-US).
        name:
          type: string
          description: Market country name.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````