How to Contact Support
For any issues, questions, or assistance, our support team is available to help. You can reach us through the following channels:
Email Support: [email protected]
Slack Channel: If you have a dedicated Slack channel with us, you can post your question there.
Submitting a Support Request
To help us resolve your issue efficiently, please provide the following details when submitting a request:
- Steps to Replicate: Describe the exact steps you took before encountering the issue.
- API Endpoint Used: Specify which API endpoint you were using.
- Exact Request Sent: Include the request payload.
an example request:{ "request_context": { "seller_id": "sample_seller" }, "businesses_to_match": [ { "name": "apple", "domain": "apple.com" }, { "name": "explorium", "domain": "explorium.ai" } ] }
- Expected Response: What result did you expect to receive?
- Actual Response: Provide the actual response you received.
an example response:{ "response_context": { "correlation_id": "7a446e57517e43c187f89339ab552dad", "request_status": "success", "time_took_in_seconds": 5.17 }, "total_results": 2, "total_matches": 2, "matched_businesses": [ { "input": { "name": "apple", "domain": "apple.com", "url": null }, "business_id": "8adce3ca1cef0c986b22310e369a0793" }, { "input": { "name": "explorium", "domain": "explorium.ai", "url": null }, "business_id": "340c8040bd50cbab9c7df718bbe51cc9" } ] }
- Error Message (if any): Copy and paste any error message you encountered.
- Correlation ID (if available): This can be found in the API response and helps us track your request faster.
Example Support Request:
{
"issue": "Received a 403 error when calling the Fetch Business Events API",
"steps_to_replicate": "Sent a request to `/businesses/events` with valid parameters",
"exact_request_send": "<copy the exact request payload here>",
"expected_response": "A list of recent business events",
"actual_response": {
"error": "You have insufficient credits to perform this operation."
},
"correlation_id": "4826416550f648e58cc9e2ceee2529b7"
}
Credit Usage Policy:
- If a request returns an error (e.g.,
403 Forbidden
,400 Bad Request
), no credits will be deducted. - If a request returns no results (i.e., no relevant data is available for the given parameters), no credits will be deducted.
- Credits are consumed only when valid, billable data is returned from the API.
Common Issues & Troubleshooting
I received a 403 Forbidden
error.
403 Forbidden
error.- Check if your API key is valid and has sufficient permissions.
- Ensure you have available credits for the requested operation.
- If using a protected endpoint, confirm you have the necessary access rights.
I received a 400 Bad Request
error.
400 Bad Request
error.- Verify that all request parameters are formatted correctly.
- Ensure the required fields are included in the request.
I received a 429 Too Many Requests
error.
429 Too Many Requests
error.- You have exceeded the rate limit for API calls. Implement exponential backoff before retrying.
- Monitor your API usage and consider upgrading your plan if needed.
I received a 500 Internal Server Error
.
500 Internal Server Error
.- This could indicate a temporary issue on our side. Try again later, and if the problem persists, contact support with your correlation ID.