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

# /funda/listings

> Get full Funda real estate listing details by listing id (or listing URL): address, neighbourhood, asking/rental price, living area, volume, number of rooms and bedrooms, energy label, build year, object and offering type, status, full description, photos, coordinates, selling agent, neighbourhood statistics, sale history (for sold/rented listings) and the full grouped characteristics (Kenmerken) sections.

**Price:** 5 credits

**⚠️ Common errors:** 412: Listing not found (well-formed but nonexistent listing id)



## OpenAPI

````yaml /openapi/real-estate.json post /api/funda/listings
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/funda/listings:
    post:
      tags:
        - /funda
      summary: /funda/listings
      description: >-
        Get full Funda real estate listing details by listing id (or listing
        URL): address, neighbourhood, asking/rental price, living area, volume,
        number of rooms and bedrooms, energy label, build year, object and
        offering type, status, full description, photos, coordinates, selling
        agent, neighbourhood statistics, sale history (for sold/rented listings)
        and the full grouped characteristics (Kenmerken) sections.


        **Price:** 5 credits


        **⚠️ Common errors:** 412: Listing not found (well-formed but
        nonexistent listing id)
      operationId: __api_funda_listings_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FundaListingsPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/FundaListing'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    FundaListingsPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        listing:
          type: string
          minLength: 1
      type: object
      required:
        - listing
    FundaListing:
      properties:
        '@type':
          type: string
          default: FundaListing
        id:
          type: string
        global_id:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        object_type:
          anyOf:
            - type: string
            - type: 'null'
        offering_type:
          anyOf:
            - type: string
            - type: 'null'
        status:
          anyOf:
            - type: string
            - type: 'null'
        is_sold_or_rented:
          anyOf:
            - type: boolean
            - type: 'null'
        labels:
          items:
            type: string
          type: array
          default: []
        address:
          anyOf:
            - $ref: '#/components/schemas/FundaListingAddress'
            - type: 'null'
        blikvanger:
          anyOf:
            - type: string
            - type: 'null'
        price:
          anyOf:
            - type: integer
            - type: 'null'
        price_label:
          anyOf:
            - type: string
            - type: 'null'
        living_area_m2:
          anyOf:
            - type: integer
            - type: 'null'
        volume_m3:
          anyOf:
            - type: integer
            - type: 'null'
        room_count:
          anyOf:
            - type: integer
            - type: 'null'
        bedroom_count:
          anyOf:
            - type: integer
            - type: 'null'
        energy_label:
          anyOf:
            - type: string
            - type: 'null'
        build_year:
          anyOf:
            - type: integer
            - type: 'null'
        coordinates:
          items:
            type: number
          type: array
          default: []
        publication_date:
          anyOf:
            - type: string
            - type: 'null'
        views:
          anyOf:
            - type: integer
            - type: 'null'
        saves:
          anyOf:
            - type: integer
            - type: 'null'
        images:
          items:
            type: string
          type: array
          default: []
        agent:
          anyOf:
            - $ref: '#/components/schemas/FundaListingAgent'
            - type: 'null'
        neighbourhood:
          anyOf:
            - $ref: '#/components/schemas/FundaNeighbourhood'
            - type: 'null'
        sale_history:
          anyOf:
            - $ref: '#/components/schemas/FundaListingSaleHistory'
            - type: 'null'
        feature_sections:
          items:
            $ref: '#/components/schemas/FundaListingFeatureSection'
          type: array
          default: []
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    FundaListingAddress:
      properties:
        '@type':
          type: string
          default: FundaListingAddress
        street:
          anyOf:
            - type: string
            - type: 'null'
        house_number:
          anyOf:
            - type: string
            - type: 'null'
        postcode:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        neighbourhood:
          anyOf:
            - type: string
            - type: 'null'
        province:
          anyOf:
            - type: string
            - type: 'null'
        country:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    FundaListingAgent:
      properties:
        '@type':
          type: string
          default: FundaListingAgent
        id:
          anyOf:
            - type: string
            - type: 'null'
        association:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    FundaNeighbourhood:
      properties:
        '@type':
          type: string
          default: FundaNeighbourhood
        city:
          anyOf:
            - type: string
            - type: 'null'
        name:
          anyOf:
            - type: string
            - type: 'null'
        inhabitants:
          anyOf:
            - type: integer
            - type: 'null'
        families_with_children:
          anyOf:
            - type: number
            - type: 'null'
        average_asking_price_per_m2:
          anyOf:
            - type: integer
            - type: 'null'
      type: object
    FundaListingSaleHistory:
      properties:
        '@type':
          type: string
          default: FundaListingSaleHistory
        offered_since:
          anyOf:
            - type: string
            - type: 'null'
        sale_date:
          anyOf:
            - type: string
            - type: 'null'
        days_on_market:
          anyOf:
            - type: string
            - type: 'null'
      type: object
    FundaListingFeatureSection:
      properties:
        '@type':
          type: string
          default: FundaListingFeatureSection
        features:
          items:
            $ref: '#/components/schemas/FundaListingFeature'
          type: array
          default: []
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
    FundaListingFeature:
      properties:
        '@type':
          type: string
          default: FundaListingFeature
        label:
          anyOf:
            - type: string
            - type: 'null'
        value:
          anyOf:
            - type: string
            - type: 'null'
      type: object
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````