How Credits and Daily Rate Limits Work with API Calls
Credit Consumption: Each API call consumes one credit, but only if it returns results. If no results are returned, your credit balance remains unchanged.
Daily Rate Limits: Every API call contributes to the daily rate limit, regardless of whether results are returned. This limit is independent of credit usage and is based on the number of calls made within a 24-hour period.
API Access by Plan
Basic Plan: No API access is included with this plan
Professional Plan: Comes with 5,000 API calls per day, ideal for moderate automation needs or integrations. The rate limit is 180 requests per minute.
Organization Plan: Offers up to 20,000 API calls per day, suitable for high-volume workflows and advanced integrations. The rate limit is 300 requests per minute.
Exceeding Limits: The Organization subscription offers a higher limit of 20,000 calls per day for users needing greater capacity beyond the Professional plan.
Limit Notification: When the daily rate limit is reached, the HTTP status code 429 is returned, accompanied by a "Rate limit exceeded" message.
Using SalesQL API: Accessing the SalesQL API does not require a valid LinkedIn account. Simply having an API key generated from the enrichment dashboard or documented in readme.io is sufficient.
Data Storage: Results from SalesQL API calls are not stored in the dashboard or extension by default. This includes contact information retrieved via API, which can be accessed programmatically.
Mail Status: The API distinguishes between verified and unverified email addresses through the "mail status" field.
Verifying Phone and Email Validity: The API now includes fields for verifying phone numbers and email addresses. Phone validity is indicated by the "is_valid" boolean field, while email status appears as "Valid" or "Unverifiable." Empty arrays indicate absence of emails or phones for a contact.
Managing API Rate Limits and Daily Quotas:
For efficient usage, maintain a maximum rate of 180 requests per minute for the Professional Plan and 300 requests per minute for the Organization Plan. A recommended 200-millisecond pause between calls ensures optimal performance and prevents reaching the rate limit.
💡 The API KEY header is mandatory for every request to our service.
Why Can’t the API Find Results?
Even though SalesQL boasts a massive database of B2B contacts, our search algorithm is all about precision. If there's any doubt about the accuracy of the results, it won’t show them. To keep our accuracy rate high and false positives low, sometimes results might not appear.
Prohibited Practices: 🚫
Automating requests against non-public API endpoints is strictly prohibited and does not align with our usage guidelines. Such actions can result in account suspension and potential loss of access to our services. ⚠️ Users are expected to adhere to the established rate limits and guidelines to ensure fair usage and optimal performance of the SalesQL API. For detailed information regarding our terms and conditions, please refer to our Terms of Service
Please visit the API documentation page for more information on supported API requests.