Frequently Asked Questions
Common questions and answers about the Traceback Search API.
General Usage
Can I search by message content?
Yes, use the message_content parameter to search for specific keywords or phrases in spam messages. Searches are case-insensitive and support partial matching.
What's the maximum date range for searches?
You can search up to 1 year of historical data in a single request. For longer periods, make multiple requests with smaller date ranges.
Data and Privacy
Is personal information included in the data?
No, all personal information is stripped from spam reports. We only provide sender numbers, message patterns, timestamps, and carrier information.
How do you ensure data accuracy?
We use machine learning algorithms to validate spam reports and remove false positives. Reports are cross-referenced across multiple sources and carriers for verification.
Billing and Limits
How are API calls billed?
Each search request counts as one API call, regardless of the number of results returned. Export requests are billed separately based on the amount of data exported.
What happens if I exceed my rate limit?
The API will return a 429 status code with a Retry-After header indicating when you can make the next request. Implement exponential backoff to handle rate limits gracefully.
Can I upgrade my plan mid-month?
Yes, plan upgrades take effect immediately. You'll be prorated for the remaining days in your billing cycle and gain access to higher rate limits right away.
Technical Support
How do I report API issues?
Contact our support team at api-support@numberintelligence.com with your API key, request details, and error messages. Include timestamps for faster troubleshooting.
Do you provide SDKs or libraries?
We provide official SDKs for Python, JavaScript, and PHP. Community-maintained libraries are available for other languages. Check our SDK documentation for details.