> ## 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.

# /realtorca/agents/search

> Search Canada's national REALTOR® directory by city, province, name, brokerage, street address, postal code, professional designations, languages spoken and specialties.

**Price:** 5 credits per 20 results



## OpenAPI

````yaml /openapi/real-estate.json post /api/realtorca/agents/search
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/realtorca/agents/search:
    post:
      tags:
        - /realtorca
      summary: /realtorca/agents/search
      description: >-
        Search Canada's national REALTOR® directory by city, province, name,
        brokerage, street address, postal code, professional designations,
        languages spoken and specialties.


        **Price:** 5 credits per 20 results
      operationId: __api_realtorca_agents_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RealtorcaAgentsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RealtorcaAgentCard'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    RealtorcaAgentsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        count:
          type: integer
          maximum: 600
          minimum: 1
        city:
          anyOf:
            - type: string
            - type: 'null'
        province:
          anyOf:
            - $ref: '#/components/schemas/RealtorcaProvince'
            - type: 'null'
        first_name:
          anyOf:
            - type: string
            - type: 'null'
        last_name:
          anyOf:
            - type: string
            - type: 'null'
        company_name:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        postal_code:
          anyOf:
            - type: string
            - type: 'null'
        designations:
          anyOf:
            - items:
                $ref: '#/components/schemas/RealtorcaDesignation'
              type: array
            - type: 'null'
        languages:
          anyOf:
            - items:
                $ref: '#/components/schemas/RealtorcaLanguage'
              type: array
            - type: 'null'
        specialties:
          anyOf:
            - items:
                $ref: '#/components/schemas/RealtorcaSpecialty'
              type: array
            - type: 'null'
        is_ccc_member:
          type: boolean
          default: false
        sort:
          $ref: '#/components/schemas/RealtorcaAgentSort'
          default: no_preference
      type: object
      required:
        - count
    RealtorcaAgentCard:
      properties:
        '@type':
          type: string
          default: RealtorcaAgentCard
        id:
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
        position:
          anyOf:
            - type: string
            - type: 'null'
        credentials:
          anyOf:
            - type: string
            - type: 'null'
        address:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        profile_url:
          anyOf:
            - type: string
            - type: 'null'
        phones:
          items:
            type: string
          type: array
          default: []
        websites:
          items:
            type: string
          type: array
          default: []
        social_links:
          items:
            type: string
          type: array
          default: []
        office_id:
          anyOf:
            - type: string
            - type: 'null'
        office_name:
          anyOf:
            - type: string
            - type: 'null'
        office_designation:
          anyOf:
            - type: string
            - type: 'null'
        office_address:
          anyOf:
            - type: string
            - type: 'null'
        office_image:
          anyOf:
            - type: string
            - type: 'null'
      type: object
      required:
        - id
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    RealtorcaProvince:
      type: string
      enum:
        - alberta
        - british_columbia
        - manitoba
        - new_brunswick
        - newfoundland_and_labrador
        - northwest_territories
        - nova_scotia
        - nunavut
        - ontario
        - prince_edward_island
        - quebec
        - saskatchewan
        - yukon
    RealtorcaDesignation:
      type: string
      enum:
        - accredited_buyer_representative
        - accredited_buyer_representative_manager
        - at_home_with_diversity_certification
        - accredited_land_consultant
        - accredited_residential_manager
        - associate_reserve_planner
        - certified_commercial_investment_member
        - certified_international_property_specialist
        - certified_leasing_officer
        - certified_manager_of_condominiums
        - certified_property_manager
        - certified_real_estate_specialist
        - certified_real_estate_brokerage_manager
        - counselor_of_real_estate
        - certified_in_real_estate_finance
        - certified_reserve_planner
        - certified_residential_specialist
        - certified_residential_underwriter
        - realtor_e_pro
        - fellow_of_the_real_estate_institute
        - fellow_of_the_real_estate_institute_appraisal_specialist
        - fellow_of_the_real_estate_institute_executive
        - general_accredited_appraiser
        - graduate_realtor_institute
        - performance_management_network
        - residential_accredited_appraiser
        - realtor_association_certified_executive
        - real_estate_professional_assistant
        - accredited_appraiser_canadian_institute
        - market_value_appraiser_residential
        - accredited_leasing_officer
        - accredited_mortgage_professional
        - accredited_senior_appraiser
        - certified_valuation_analyst
        - certified_mold_remediation
        - certified_professional_residential_property_manager
        - canadian_residential_appraiser
        - fellows_of_the_royal_institution_of_chartered_surveyors
        - member_appraisal_institute
        - professional_land_economist
        - real_property_administrator
        - society_of_industrial_and_office_realtors
        - senior_residential_appraiser
        - canadian_employee_relocation_professional
        - canadian_employee_relocation_council_relocation_specialist
        - relocation_resort_specialist
        - seniors_real_estate_specialist
        - certified_lease_professional_designation
        - designated_agency_representatives
        - distinguished_real_estate_instructor
        - unknown
        - certified_condo_specialist
        - canadian_realtor_association_executive
        - nar_s_green_designation
        - accredited_greenagent_residential
        - accredited_greenbroker_commercial
        - ecobroker
        - transnational_referral_certified
        - certified_negotiation_expert
        - member_of_the_royal_institute_of_charter_surveyors
        - certified_reserve_fund_planner
        - accredited_staging_professional
        - resort_and_second_home_property_specialist
        - short_sales_and_foreclose_resource
        - business_corporation_owned_by_a_real_estate_broker
        - canadian_personal_property_appraiser
        - seller_representative_specialist
        - accredited_senior_agent
        - certified_luxury_home_marketing_specialist
        - royal_institute_of_chartered_surveyors
        - accredited_commercial_professional
        - master_certified_negotiation_expert
        - associate_of_the_canadian_condominium_institute
        - real_estate_negotiation_expert
        - military_relocation_professional
        - pricing_strategy_advisor
        - accredited_luxury_home_specialist
        - performance_management_network_designation
        - certified_in_marketing_of_real_estate
        - residential_construction_certified
        - certified_new_home_specialist
        - chartered_accountant
        - chartered_professional_accountant
        - certified_general_accountant
        - certified_management_accountant
        - boundarywise
        - chartered_financial_analyst
        - national_commercial_real_estate_advisor
        - certified_real_estate_investment_planning_specialist
        - openn_certified_agent
        - accredited_real_estate_negotiator
        - luxury_homes_certification
        - canadian_national_association_of_real_estate_appraisers
        - certified_real_estate_team_specialist
        - certified_consultant_on_aging
        - certified_buyer_agent_expert
        - canadian_certified_green_representative_ccgr
        - accredited_commercial_manager
        - real_estate_sector_governance_designation
        - canadian_certified_seniors_representative_ccsr
    RealtorcaLanguage:
      type: string
      enum:
        - english
        - french
        - chinese_mandarin
        - chinese_cantonese
        - punjabi
        - hindi
        - tagalog_filipino
        - arabic
        - russian
        - german
        - aboriginal_languages
        - afrikaans
        - albanian
        - american_sign_language_asl
        - amharic
        - armenian
        - assyrian
        - azeri
        - bahasa_malaysia
        - bangla
        - belorussian
        - bulgarian
        - burmese
        - catalan
        - chaldean
        - cree
        - creole
        - croatian
        - czech
        - danish
        - dari
        - dutch
        - estonian
        - farsi
        - finnish
        - flemish
        - friesian
        - galla
        - gan
        - georgian
        - greek
        - gujarati
        - hakka
        - hausa
        - hebrew
        - hungarian
        - icelandic
        - indonesian
        - inuktitut_inuit
        - italian
        - japanese
        - javanese
        - jin_yu
        - kannada
        - kazakh
        - kejia
        - khmer
        - kiswahili
        - konkani
        - korean
        - kurdish
        - lao
        - latvian
        - lithuanian
        - luxembourgish
        - macedonian
        - malagasy
        - malay
        - malayalam
        - malaysian
        - maltese
        - marathi
        - miny
        - mongolian
        - norwegian
        - pakhto
        - pashto
        - persian
        - polish
        - portuguese
        - romanian
        - serbian
        - serbo_croatian
        - sindhi
        - sinhala
        - slovak
        - slovenian
        - somali
        - spanish
        - sunda
        - swedish
        - tajik
        - tamil
        - tchi
        - telugu
        - thai
        - tigrinya
        - turkish
        - ukrainian
        - urdu
        - uzbek
        - vietnamese
        - xiang
        - yiddish
        - yue
    RealtorcaSpecialty:
      type: string
      enum:
        - residential_property_management
        - residential_brokerage
        - residential_development
        - residential_valuation
        - residential_financing
        - residential_leasing
        - residential_legal
        - residential_relocation
        - relocation
        - second_home
        - age_restricted_active_adult_community_properties
        - agriculture_land
        - appraisal
        - business_brokerage
        - condos
        - consulting
        - development_land
        - farm_ranch
        - golf_community_properties
        - hospitality
        - industrial
        - investment
        - luxury_homes
        - multi_family
        - office
        - property_management
        - recreational
        - resort_properties
        - retail
        - seasonal_vacation_rentals
        - single_family
        - waterfront_properties
    RealtorcaAgentSort:
      type: string
      enum:
        - no_preference
        - last_name_asc
        - last_name_desc
        - first_name_asc
        - first_name_desc
        - city_asc
        - city_desc
        - province_asc
        - province_desc
    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
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````