> ## 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. # /fotocasa/agencies/listings > Get a Fotocasa real estate agency profile and its published listings by numeric agency client id. Returns the agency profile (name, contact details, address, coordinates, logo, quality seal, counters) together with the agency's property listings (same cards as the property search). **Price:** 20 credits per 15 results **⚠️ Common errors:** 412: Agency not found (well-formed but nonexistent client id) ## OpenAPI ````yaml /openapi/real-estate.json post /api/fotocasa/agencies/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/fotocasa/agencies/listings: post: tags: - /fotocasa summary: /fotocasa/agencies/listings description: >- Get a Fotocasa real estate agency profile and its published listings by numeric agency client id. Returns the agency profile (name, contact details, address, coordinates, logo, quality seal, counters) together with the agency's property listings (same cards as the property search). **Price:** 20 credits per 15 results **⚠️ Common errors:** 412: Agency not found (well-formed but nonexistent client id) operationId: __api_fotocasa_agencies_listings_post parameters: - name: access-token in: header required: true schema: anyOf: - type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/FotocasaAgenciesListingsPayload' responses: '200': description: Successful Response content: application/json: schema: type: array items: $ref: '#/components/schemas/FotocasaAgencyListings' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: FotocasaAgenciesListingsPayload: properties: timeout: type: integer maximum: 1500 minimum: 20 default: 300 client_id: type: string minLength: 1 transaction: $ref: '#/components/schemas/FotocasaTransaction' default: comprar min_price: anyOf: - type: integer minimum: 0 - type: 'null' max_price: anyOf: - type: integer minimum: 0 - type: 'null' min_surface: anyOf: - type: integer minimum: 0 - type: 'null' max_surface: anyOf: - type: integer minimum: 0 - type: 'null' min_rooms: anyOf: - type: integer minimum: 0 - type: 'null' max_rooms: anyOf: - type: integer minimum: 0 - type: 'null' min_bathrooms: anyOf: - type: integer minimum: 0 - type: 'null' count: type: integer minimum: 1 type: object required: - client_id - count FotocasaAgencyListings: properties: '@type': type: string default: FotocasaAgencyListings agency: anyOf: - $ref: '#/components/schemas/FotocasaAgencyProfile' - type: 'null' listings: items: $ref: '#/components/schemas/FotocasaPropertyCard' type: array default: [] type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array type: object FotocasaTransaction: type: string enum: - comprar - alquiler FotocasaAgencyProfile: properties: '@type': type: string default: FotocasaAgencyProfile client_id: type: string name: anyOf: - type: string - type: 'null' alias: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' phones: items: type: string type: array default: [] web: anyOf: - type: string - type: 'null' web_domain: anyOf: - type: string - type: 'null' address: anyOf: - type: string - type: 'null' address_url: anyOf: - type: string - type: 'null' town: anyOf: - type: string - type: 'null' province: anyOf: - type: string - type: 'null' zip_code: anyOf: - type: string - type: 'null' coordinates: anyOf: - $ref: '#/components/schemas/FotocasaCoordinates' - type: 'null' image: anyOf: - type: string - type: 'null' has_quality_seal: anyOf: - type: boolean - type: 'null' agent_count: anyOf: - type: integer - type: 'null' franchisee_count: anyOf: - type: integer - type: 'null' created_at: anyOf: - type: string - type: 'null' publisher_id: anyOf: - type: string - type: 'null' type: object required: - client_id FotocasaPropertyCard: properties: '@type': type: string default: FotocasaPropertyCard id: type: string real_estate_ad_id: anyOf: - type: string - type: 'null' url: anyOf: - type: string - type: 'null' property_type: anyOf: - type: string - type: 'null' transaction_type: anyOf: - type: string - type: 'null' price: anyOf: - type: integer - type: 'null' price_drop: anyOf: - type: integer - type: 'null' price_per_m2: anyOf: - type: number - type: 'null' surface: anyOf: - type: integer - type: 'null' room_count: anyOf: - type: integer - type: 'null' bathroom_count: anyOf: - type: integer - type: 'null' floor: anyOf: - type: integer - type: 'null' condition: anyOf: - type: string - type: 'null' antiquity: anyOf: - type: string - type: 'null' orientation: anyOf: - type: string - type: 'null' is_furnished: anyOf: - type: boolean - type: 'null' created_at: anyOf: - type: string - type: 'null' is_new: anyOf: - type: boolean - type: 'null' is_new_construction: anyOf: - type: boolean - type: 'null' is_occupied: anyOf: - type: boolean - type: 'null' is_auctioned: anyOf: - type: boolean - type: 'null' is_bare_ownership: anyOf: - type: boolean - type: 'null' is_rented_with_tenants: anyOf: - type: boolean - type: 'null' is_premium: anyOf: - type: boolean - type: 'null' has_video: anyOf: - type: boolean - type: 'null' has_virtual_tour: anyOf: - type: boolean - type: 'null' has_quality_seal: anyOf: - type: boolean - type: 'null' features: items: type: string type: array default: [] address: anyOf: - $ref: '#/components/schemas/FotocasaAddress' - type: 'null' images: items: type: string type: array default: [] agency: anyOf: - $ref: '#/components/schemas/FotocasaCardAgency' - type: 'null' type: object required: - id 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 FotocasaCoordinates: properties: '@type': type: string default: FotocasaCoordinates latitude: anyOf: - type: number - type: 'null' longitude: anyOf: - type: number - type: 'null' type: object FotocasaAddress: properties: '@type': type: string default: FotocasaAddress street: anyOf: - type: string - type: 'null' street_number: anyOf: - type: integer - type: 'null' neighborhood: anyOf: - type: string - type: 'null' district: anyOf: - type: string - type: 'null' municipality: anyOf: - type: string - type: 'null' locality: anyOf: - type: string - type: 'null' region: anyOf: - type: string - type: 'null' province: anyOf: - type: string - type: 'null' autonomous_community: anyOf: - type: string - type: 'null' country: anyOf: - type: string - type: 'null' zip_code: anyOf: - type: string - type: 'null' coordinates: anyOf: - $ref: '#/components/schemas/FotocasaCoordinates' - type: 'null' type: object FotocasaCardAgency: properties: '@type': type: string default: FotocasaCardAgency client_id: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' type: anyOf: - type: string - type: 'null' url: anyOf: - type: string - type: 'null' publisher_id: anyOf: - type: string - type: 'null' type: object securitySchemes: AccessToken: type: apiKey in: header name: access-token description: API token from the dashboard ````