Frequently Asked Questions
How should we use the API?
The BetterDoctor API allows you to access the most comprehensive and consistently updated physician and practice data available. Whether you’re looking to build a custom search interface for your app, enrich physician profiles, or improve your service, view our full list of data models for a complete list.
What is the source of your data?
Our data is compiled from multiple sources, including public records, partnerships with data providers, manual verification, and updates made by physicians and practice managers themselves.
How do you ensure data accuracy?
We use a combination of automated algorithms, manual verification, multi-source data validation and end user data strategies to ensure data quality and accuracy.
How often will data be updated?
Weekly. We will update the data pipeline as new data becomes available. Note: some data will updated monthly or quarterly based on when we receive it from our partners.
May I store the data locally?
In order to properly display consistent and correct data to your end users, you should not implement any caching strategies. The only exception to this is caching the BetterDoctor unique identifiers.
Is any additional data available?
Additional data (e.g., NPI numbers) is available by special request. Please contact us to discuss your unique needs.
What are the most common use cases?
You can find out more about different use cases by going to our case studies here. Some examples include patient record keeping apps that use our API to direct users to appropriate doctors or doctor finder apps.
Why is my access being throttled?
In order to ensure quality service for all API partners, we enforce default rate limits for all free tier API users. If you are interested in discussing a premium account with higher rate limits, please get in touch with us.
When do you plan to provide OAuth based authentication?
We will introduce OAuth in the next version. Sign up now and we’ll notify you as soon as it’s available.
How do I match my data with yours?
You’re in luck! We’ve already matched raw data with physician and provider profiles. Should your data be unstructured or not include a unique public identifier (e.g., NPI number), please contact us for assistance matching records.
Where can I get more information?
Please send us an email to firstname.lastname@example.org, and we will help.
How often will you update the API?
While the API provides comprehensive set of functionalities already today, we are committed to improving the API. We will notify you about the new features we add to the API via newsletters and provide information about any updates on developer.betterdoctor.com.