NeverBounce uses a REST API.
NeverBounce provides API wrappers for several programming languages including PHP, Ruby, NodeJS, Python, Go, .NET, and Java. These wrappers likely make it easier to integrate the REST API into applications built with those languages.
Yes, the official NeverBounce API does have webhooks, but they are limited in scope and functionality.
The NeverBounce API doesn't offer a wide range of events to subscribe to via webhooks. Instead, it provides a specific webhook functionality for email verification. The main use case for webhooks in NeverBounce is for single email verification, which can be integrated into existing tools or CRMs.
The webhook functionality is primarily used with the single/check
endpoint.
To create a webhook, you need to follow a specific link provided by NeverBounce, which will give you a URL with a webhook secret key.
The webhook URL looks like this:
https://api.neverbounce.com/v4.2/single/check?key=webhook_secret_abcdefghijklmnopqrstuvwxyz&email={email}
You replace {email}
with the email you want to verify.
Additional parameters like address_info
and credits_info
can be added to the webhook URL for more detailed information.
It's important to note that these webhooks are not safe to use in client-side scripts (e.g., jQuery, JavaScript) because they contain sensitive API keys.
Use webhooks for single email verification in response to specific actions, like form submissions or button clicks.
Do not use single verification (including webhooks) for verifying emails in an existing list or database one-by-one. This may result in your account being locked.
For bulk verification of email lists or databases, use the bulk verification feature instead of webhooks.
Treat the webhook URL and its secret key with the same level of security as you would treat a regular API key.
In summary, while NeverBounce does offer webhook functionality, it's primarily designed for single email verification integration rather than a comprehensive event subscription system. For more complex use cases or bulk verifications, you should consider using other features of the NeverBounce API.
Here are the key points about the API rate limits for the NeverBounce API:
The NeverBounce API implements rate limiting and payload size restrictions primarily on bulk verification jobs. Following their usage guidelines and implementing proper error handling will help ensure smooth API usage within the specified limits.
Based on the search results provided, the most recent version of the NeverBounce API appears to be V4. Here are the key points:
The NeverBounce API is a RESTful API that uses HTTPS connections and returns responses as JSON [2].
The API is not suitable for direct use in client-side scripts (e.g. jQuery, Javascript) due to security concerns. A Javascript Widget is provided for client-side use instead [2].
API requests are authenticated using an API key that looks like this: secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
[3][5].
NeverBounce provides official API wrappers for several programming languages, including:
Use the provided API wrappers when possible for easier integration [2].
When making API requests, always use HTTPS and include your API key for authentication [2][3][5].
Be aware that the V3 API credentials (username and secret key) will not work with the V4 API. You need to obtain new V4 API credentials [3][5].
When working with bulk jobs, you can attach metadata to each email object in the job input listing [5].
For paginated results (like job searches), use the provided iterator methods to handle pagination automatically [5].
Here's a basic example of using the Python SDK to check a single email:
import neverbounce_sdk api_key = 'secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' client = neverbounce_sdk.client(api_key=api_key, timeout=30) resp = client.single_check('[email protected]') print(resp['result']) # e.g., 'invalid' print(resp['execution_time']) # e.g., 285
This example demonstrates how to initialize the client with your API key and perform a single email check [5].
To get a developer account for NeverBounce and create an API integration, follow these steps:
Create a NeverBounce account:
Log in to your NeverBounce account:
Create a Custom Integration App:
Access your API key:
Use the API key for authentication:
secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
.Based on the search results provided, here is a summary of the data models you can interact with using the NeverBounce API:
Single Email Verification:
Bulk Email Validation:
Create Jobs:
Check Job Status:
Retrieve Results:
API Integration:
JavaScript Widget:
API Key Management:
Usage Tracking:
NeverBounce's API provides a versatile set of data models and endpoints to cover various email verification needs, from individual checks to large-scale list management and integration with existing systems.