FAQ
Q: How long are API keys valid?
A: API keys don't expire but can be revoked. Contact support for new keys.
Q: Can I use one API key for multiple applications?
A: Yes, but monitor usage separately with different API keys for better security.
Q: What's the maximum number of properties per agent?
A: No limit. Use pagination to handle large result sets.
Q: Are there batch endpoints for multiple properties?
A: Not currently. Use pagination to retrieve multiple properties efficiently.
Q: Can I filter properties by price range?
A: Not in the API. Filter results in your application.
Q: How often is property data updated?
A: Data updates hourly from MLS feeds.
Q: Can I get historical property data?
A: Contact support for historical data access.
Q: Is there a sandbox/test environment?
A: Use v2 with test API keys for testing.
Troubleshooting
Problem: 401 Unauthorized
Causes:
- API key missing or incorrect
- API key revoked
- Wrong header name
Solution:
# Verify header format
curl -H 'apikey: YOUR_KEY' https://ws.spac.io/api/v1/getProperties
# Not: api-key or Api-Key
Problem: 429 Rate Limited
Causes:
- Exceeded 12,000 requests/hour
- Too many concurrent requests
Solution:
- Wait for rate limit reset
- Implement exponential backoff
- Cache frequently accessed data
Problem: Empty Results
Causes:
- Wrong property/agent ID
- Data doesn't exist
- No access permissions
Solution:
# Verify ID exists
if response['success'] and response['data']:
print(response['data'])
else:
print('No results found')
Problem: Slow Responses
Causes:
- Large result sets
- Network latency
- Server load
Solution:
- Reduce page limit
- Use caching
- Add timeout handling
Problem: Inconsistent Data
Causes:
- Data updated between requests
- Timing issues
Solution:
- Add updated_at timestamp comparison
- Implement caching strategy
- Sync less frequently if needed
Getting Help
- Email: support@spac.io
- Phone: 1-800-SPACIO-1
- Status page: status.spac.io
- Community: forums.spac.io