Skip to main content
Órulo is a Brazilian real estate marketplace platform that connects developers, brokers, and real estate agencies. It provides a comprehensive catalog of properties (empreendimentos), including building details, typologies, units, images, floor plans, and commercial partners.

​
Configuring Órulo as a Source

In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the Órulo option from the list of connectors. Click Next and you’ll be prompted to add your access.

​
1. Add account access

You’ll need OAuth2 client credentials to connect. These are provided by Órulo when you sign a partnership contract. The following configurations are available:
  • Client ID: Your OAuth2 client ID provided by Órulo.
  • Client Secret: Your OAuth2 client secret provided by Órulo.
  • Start Date: (Optional) The earliest date from which records will be synced, in DD/MM/YYYY HH:MM:SS format.
Once you’re done, click Next.

​
2. Select streams

Choose which data streams you want to sync. For faster extractions, select only the streams that are relevant to your analysis.
Tip: The stream can be found more easily by typing its name.
Select the streams and click Next.

​
3. Configure data streams

Customize how you want your data to appear in your catalog. Select the desired layer, a folder to organize it, a name for each table, and the type of sync.
  • Layer: choose between the existing layers on your catalog.
  • Folder: a folder can be created inside the selected layer to group all tables.
  • Table name: we suggest a name, but feel free to customize it.
  • Sync Type: choose between INCREMENTAL and FULL_TABLE.
Once you are done configuring, click Next.

​
4. Configure data source

Describe your data source for easy identification within your organization. Define your Trigger based on how often you need data updated. Once you are ready, click Next to finalize the setup.

​
5. Check your new source

You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button.
For you to be able to see it on your Catalog, you need at least one successful source run.

​
Streams and Fields

Below you’ll find all available data streams from Órulo and their corresponding fields:

​
Implementation Notes

​
API Limits & Performance

  • Rate Limiting (HTTP 429): The connector automatically manages Órulo’s API rate limits. It respects the Retry-After header to pause requests when limits are exceeded and employs an exponential backoff strategy (up to 10 retries) to ensure continuous and reliable data extraction.
  • Request Pacing: To proactively avoid triggering Órulo’s rate limits during extraction, a short delay (0.5 seconds) is intentionally introduced between consecutive requests for child streams (e.g., Typologies, Images, Floor Plans, and Units).
  • Missing Records (HTTP 404): If a specific building is missing or unavailable on Órulo’s upstream (returning a 404 Not Found error), the connector will gracefully skip the building and log a warning instead of failing the entire sync, ensuring robust partial data fetching.

​
Skills for agents

Download Órulo skills file

Órulo connector documentation as plain markdown, for use in AI agent contexts.