Back

BoomTown API Essential Guide

Aug 16, 20246 minute read

What type of API does BoomTown provide?

Based on the search results provided, there is no specific information about what type of API BoomTown uses. The search results contain general information about different API types like REST, SOAP, GraphQL, and gRPC, but do not mention BoomTown's API specifically.

To answer this question accurately, we would need more specific information about BoomTown's API documentation or implementation. Without that, I cannot determine what type of API BoomTown uses.

If you need to know the specific API type used by BoomTown, I would recommend:

  1. Checking BoomTown's official API documentation, if available.
  2. Contacting BoomTown's technical support or developer relations team directly.
  3. Examining any sample API requests or responses from BoomTown, which could provide clues about the API architecture.

In general, modern web APIs tend to use REST or GraphQL architectures, but without specific information about BoomTown, it's not possible to say definitively which type they have implemented.

Does the BoomTown API have webhooks?

Based on the search results provided, I do not have definitive information about whether the official BoomTown API offers webhooks or what specific events you can subscribe to. The search results do not contain direct information about BoomTown's official API webhook capabilities. However, I can provide some relevant information based on the available data:

Integration Possibilities

  1. BoomTown can be integrated with other applications using platforms like Zapier. This suggests that while BoomTown may not have native webhook support, it can be connected to webhook-enabled systems through third-party integration tools.

  2. Zapier allows for creating automated workflows that connect BoomTown with other applications, including webhook services.

Potential Trigger Events

While not specifically mentioning webhooks, the search results indicate that BoomTown has several events that can trigger actions in integrations, which could potentially be used with webhooks through a service like Zapier:

  • Lead Asked Question: Triggers when a lead submits a web inquiry or question on your BoomTown site.
  • Email Received: Triggers when you receive an email from one of your assigned leads.
  • Call Logged: Triggers when a call is logged for one of your assigned leads.
  • Text Received: Triggers when you receive a text message from one of your assigned leads.
  • Category Changed: Triggers when a category is changed for one of your assigned leads.
  • New Lead: Triggers when a new lead is created.
  • Tag Added: Triggers when a tag is added to an assigned lead.
  • Tag Removed: Triggers when a tag is removed from an assigned lead.
  • To-Do Created: Triggers when a To-Do is created for an assigned lead.

API Information

The search results mention that BoomTown has an API, but the details provided are limited:

  • There is a functional test page for experimenting with the API.
  • API calls require an API Token and Secret Key.
  • A previous version (v2) of the API is also available.

Key Points to Consider

  1. While BoomTown may not have native webhook support, it appears to be integratable with webhook-enabled systems through third-party services.

  2. The available trigger events suggest that BoomTown has a robust set of actions that could potentially be used with webhooks in custom integrations.

  3. For the most accurate and up-to-date information about BoomTown's official API capabilities, including webhook support, it would be best to consult BoomTown's official documentation or contact their support team directly.

In conclusion, while the search results do not provide direct confirmation of webhook support in BoomTown's official API, they do suggest that BoomTown can be integrated with webhook-enabled systems through third-party services, and there are various events that could potentially be used for webhook-like functionality in custom integrations.

Rate Limits and other limitations

Based on the search results, here are the key points about the API rate limits for the BoomTown API:

Rate Limits

  • The BoomTown API has the following rate limits:
    • 100 requests per 10 seconds limit (burst limit)
    • 2000 requests per hour limit
    • 100 failed requests per hour limit

Response Headers

  • The API provides response headers to help track usage against the limits:
    • X-Brokermint-Burst-Limit: 100
    • X-Brokermint-Burst-Remaining: Shows remaining requests in 10 second period
    • X-Brokermint-Hour-Limit: 2000
    • X-Brokermint-Hour-Remaining: Shows remaining requests in hour period
    • X-Brokermint-Hour-Reset: 13-digit Unix timestamp for when next hour cycle starts

Handling Rate Limiting

  • When rate limited, the API returns a 429 status code
  • It's recommended to add code to catch 429 responses and implement retry logic
  • Consider implementing a throttling process to regulate request rates if frequently hitting limits

Best Practices

  • Only make necessary API requests
  • Cache frequently used data where possible
  • Use webhook subscriptions instead of polling where applicable
  • Utilize batch endpoints to reduce number of requests

Key Considerations

  • Rate limits are per account, not per node
  • The hourly limit was increased from 5 to 10 requests per second in October 2022
  • There is no longer a daily request limit

In summary, the BoomTown API has both short-term burst limits and hourly limits that developers need to be aware of and handle appropriately in their integrations. Proper error handling and request management are important for working within these limits.

Latest API Version

Based on the search results provided, the most recent version of the BoomTown API is version 3 (v3). Here are the key points to consider:

  1. The search results mention both v2 and v3 of the BoomTown API [1][2].

  2. Source 0 refers to v2 as the "previous version" and provides a link to access the latest APIs (v3) [1].

  3. Source 1 describes the current API documentation and mentions that to access the previous version (v2), users can click a provided link [2].

Key Points to Consider

  • BoomTown regularly updates its API to provide new features and improvements.
  • When working with the BoomTown API, it's important to use the most recent version (v3) to ensure access to the latest functionality and support.
  • Developers should be aware that there may be differences between v2 and v3, so migrating from an older version to the newest one may require some code adjustments.

Best Practices

  1. Always use the most recent API version (v3) for new integrations or projects.
  2. Keep track of API updates and changelog to stay informed about new features or breaking changes.
  3. If you're currently using v2, consider migrating to v3 to take advantage of the latest improvements and ensure long-term compatibility.
  4. Refer to the official BoomTown API documentation for the most up-to-date information on endpoints, parameters, and usage guidelines.

By using the most recent version of the BoomTown API (v3), developers can ensure they have access to the latest features and improvements while maintaining compatibility with the platform's current standards.

How to get a BoomTown developer account and API Keys?

To get a developer account for BoomTown to create an API integration, here are the key steps:

  1. Visit the BoomTown developer portal at [https://developers.goboomtown.com/api].

  2. Request API credentials. You'll need to request an API token and secret key from BoomTown to authenticate your API requests.

  3. Review API documentation. BoomTown provides documentation on their API calls and responses on the developer portal.

  4. Test API methods. The developer portal allows you to test API methods directly using the "Try it now!" buttons after entering your credentials.

  5. Consider using the SDK. BoomTown offers a Cloud SDK that can be used for authentication and data management as an alternative to directly using the REST API.

  6. Be aware of API versions. BoomTown has multiple API versions available, with the latest being v3.

Key points to consider:

  • You'll need official API credentials from BoomTown to access the API.
  • Review rate limits, data usage policies, and terms of service before integrating.
  • Test thoroughly in a sandbox environment before going live.
  • Keep your API credentials secure and don't share them publicly.

The exact process for requesting a developer account may not be specified, so you may need to reach out to BoomTown sales or support to get approved for API access if there's no self-service option available.

What can you do with the BoomTown API?

Based on the provided search results, there is limited specific information about the data models that can be interacted with using the BoomTown API. However, I can provide some general insights based on the available information:

Data Models and Interactions

While the search results don't provide a detailed list of data models, we can infer some possibilities based on the nature of BoomTown as a real estate software platform:

  • Leads:

    • Likely ability to create, read, update, and delete lead information
    • Possibly retrieve lead activity or engagement data
  • Contacts:

    • Probably supports managing contact information
    • May allow for adding notes, tags, or categorizing contacts
  • Properties:

    • Potentially allows for retrieving property listings
    • Might support creating or updating property information
  • Users:

    • Could provide functionality to manage user accounts within the BoomTown system
  • Tasks or Activities:

    • May offer the ability to create and manage tasks related to leads or properties
  • Analytics:

    • Possibly provides access to performance metrics or reporting data

Key Points to Consider

  • The BoomTown API documentation is available for both v2 (previous version) and v3 (latest version).
  • The API provides a functional test page where developers can experiment with API calls using their API Token and Secret Key.
  • BoomTown focuses on helping real estate professionals generate leads, manage contacts, and run their business more effectively.

Best Practices

  • Always refer to the most up-to-date API documentation (currently v3) for the most accurate information on available data models and interactions.
  • Use the provided functional test page to experiment with API calls before implementing them in your application.
  • Ensure you have the necessary authentication credentials (API Token and Secret Key) to access the API.

It's important to note that without access to the full API documentation, this list is speculative and based on typical features of real estate software platforms. For accurate and detailed information about the specific data models and interactions available through the BoomTown API, you would need to consult the official API documentation or contact BoomTown directly.