Back

Thryv API Essential Guide

Sep 14, 20246 minute read

What type of API does Thryv provide?

REST (Representational State Transfer) APIs are very popular and widely used. They use standard HTTP methods and are stateless.

SOAP (Simple Object Access Protocol) APIs use XML for message formatting and are often used in enterprise environments.

GraphQL is a more modern query language for APIs that allows clients to request exactly the data they need.

RPC (Remote Procedure Call) APIs focus on actions rather than resources.

Does the Thryv API have webhooks?

Based on the search results provided, I do not have any specific information about whether the official Thryv API offers webhooks or what types of events you can subscribe to. The search results do not contain details about Thryv's official API capabilities or webhook functionality.

The search results primarily focus on Thryv's integration with Zapier, which allows users to connect Thryv to other applications through Zapier's platform. However, this does not necessarily indicate that Thryv has its own native webhook system.

To get accurate information about Thryv's official API and webhook capabilities, I would recommend:

  1. Checking Thryv's official developer documentation or API reference, if available.
  2. Contacting Thryv's support or developer relations team directly.
  3. Looking for any official announcements or blog posts from Thryv about their API features.

Without more specific information from official Thryv sources, I cannot confirm whether they offer webhooks or what events might be available for subscription.

Rate Limits and other limitations

Based on the search results provided, there is no specific information about the API rate limits for the Thryv API. However, I can provide some relevant information about API rate limits in general and what we know about Thryv's API usage:

Key Points:

  1. The search results do not contain explicit information about Thryv API rate limits.

  2. Thryv's Integration Partner Agreement mentions a limit of 10,000 API calls per day [3].

  3. API rate limits are common practice for many APIs to ensure platform stability and fair usage.

Thryv API Usage Limit:

The Thryv Integration Partner Agreement states:

"You may not... Exceed 10,000 API calls per day, or overload or take any action that imposes an unreasonable load on our infrastructure" [3].

This suggests that Thryv has implemented a daily limit of 10,000 API calls for their integration partners.

Best Practices:

  1. Respect the stated limit of 10,000 API calls per day.

  2. Implement efficient API usage to avoid unnecessary calls.

  3. Consider implementing caching mechanisms to reduce the number of API calls.

  4. Monitor your API usage to ensure you stay within the limits.

  5. If you need higher limits, contact Thryv directly to discuss your requirements.

Additional Considerations:

  • The agreement also mentions that Thryv reserves the right to review and monitor Application use metrics and verify compliance with the agreement [3].

  • Thryv may have different rate limits for different endpoints or user types, but this information is not provided in the search results.

  • It's always a good practice to check the official API documentation for the most up-to-date and accurate information on rate limits and usage guidelines.

In conclusion, while we don't have comprehensive information about Thryv's API rate limits, we know there is a daily limit of 10,000 API calls. For more detailed or specific information about rate limits, it would be best to consult Thryv's official API documentation or contact their support team directly.

Latest API Version

Unfortunately, I do not have enough information to determine the most recent version of the Thryv API. The search results do not provide any specific details about API versions or release dates. The Thryv website and integration partner agreement contain general information about their developer platform and tools, but do not mention specific API versions. Without more details from official Thryv documentation or release notes, I cannot confidently state what the latest API version is. I would recommend checking Thryv's official developer documentation or contacting their support team directly to get the most up-to-date information on their current API version.

How to get a Thryv developer account and API Keys?

Registration Process

To access Thryv's platform for Integration Partners (Developer Platform), you must follow the registration process established by Thryv, Inc. for the Integration Partner program. Key points to consider:

  • Your access to the Developer Platform is subject to Thryv's review of the information you provide at registration.
  • Access is granted at Thryv's sole and absolute discretion.
  • The information you provide during registration must be true, accurate, and kept up-to-date.

Developer Platform Access

Once registered, you will gain access to the Developer Platform, which includes:

  • Developer Tools such as APIs, SDK libraries, code, scripts, a developer console, access tokens, developer webpages, and documentation.
  • The ability to build applications, add-ons, and extensions that interact or integrate with Thryv's all-in-one small business management software solution.

License and Usage

Upon approval, Thryv grants you a limited, non-exclusive, revocable, non-transferable, and non-sublicensable license to use the Developer Tools. This license allows you to:

  • Develop, test, integrate, and support your Application in relation to the Thryv Software.
  • Use the Thryv name, logo, and other Thryv marks provided, but only for the purpose of advertising that your Application integrates with or is available for use with the Thryv Software.

Application Submission and Approval

To make your Application available on the Thryv Marketplace:

  1. Submit your Application for review and approval by Thryv, Inc.
  2. Provide accurate information about your Application, including marketing materials, EULA, documentation, and any necessary code.
  3. Address and fix any issues identified by Thryv during the approval process within the prescribed timeframe.

Best Practices

  • Keep your account credentials confidential.
  • Comply with the usage restrictions, such as not exceeding 10,000 API calls per day.
  • Ensure your Application handles user data securely and obtains appropriate consents.
  • Follow Thryv's guidelines for using their branding and marks.

What can you do with the Thryv API?

Based on the information provided in the search results, here is a list of data models that can be interacted with using the Thryv API, along with what is possible for each:

End User Data

  • Access and transfer data related to end users of your application
  • Collect data from end users or their Thryv Software/mobile devices
  • Transmit end user data to Thryv, Inc., the Thryv Software, or third parties
  • Must disclose type of data collected and how it's used in your EULA
  • Must obtain appropriate consents from end users for data collection and transfer
  • Responsible for secure storage and transmission of collected data

Customer Data

  • Interact with data from Thryv's customers who use your application
  • May involve accessing customer's Thryv Software instance

Application Data

  • Submit application information for review and approval by Thryv
  • Provide marketing materials, EULA, documentation, and download URL for your application
  • Disclose types of data collected by your application and how it's used

API Usage Data

  • Limited to 10,000 API calls per day
  • Thryv may collect and use information about your application's usage

Pre-release Materials

  • Access to pre-release products and technology for evaluation and testing purposes
  • No rights granted other than those expressly set forth

Marketplace Data

  • List your application in the Thryv Marketplace after review and approval
  • Thryv may use your application name, marketing materials, and other information for promotion

Integration Partner Materials

  • Thryv can use, store, copy, and distribute your application for testing, evaluation, and fulfilling obligations

It's important to note that the specific data models and interactions available may be subject to Thryv's approval and any additional agreements between the integration partner and Thryv, Inc.