❓ Spinny FAQ
Answers to common questions about Spinny parser and Indian used car market data
Quick Navigation
🔧 API & Technical Questions
How do I get started with Spinny API?
Getting Started
- Sign up at Carapis Dashboard
- Get your API key - starts with
spinny_parser_sk_ - Make your first request using our Quick Start Guide
- Explore endpoints in our API Reference
What programming languages are supported?
Supported Languages
- Python - Official SDK with full documentation
- JavaScript/Node.js - Complete SDK with async support
- cURL - Direct HTTP requests
- PHP - Community SDK available
- Java - REST API compatible
- C#/.NET - HTTP client compatible
How often is the data updated?
Data Freshness
- Active Listings: Updated every 15 minutes
- New Listings: Added within 30 minutes of posting
- Price Changes: Reflected within 1 hour
- Quality Updates: Inspection reports updated within 2 hours
- Historical Data: Available for up to 12 months
What are the API rate limits?
Rate Limits
| Plan | Requests/Day | Requests/Minute | Concurrent Requests |
|---|---|---|---|
| Free | 1,000 | 10 | 5 |
| Pro | 10,000 | 100 | 20 |
| Enterprise | Custom | Custom | Custom |
How do I handle API errors?
Error Handling
import requests
try:
response = requests.get(url, headers=headers)
response.raise_for_status()
data = response.json()
except requests.exceptions.HTTPError as e:
if e.response.status_code == 429:
print("Rate limit exceeded - wait and retry")
elif e.response.status_code == 401:
print("Invalid API key - check your credentials")
else:
print(f"HTTP error: {e}")
except Exception as e:
print(f"Unexpected error: {e}")
📊 Data & Accuracy Questions
How accurate is the Spinny data?
Data Accuracy
- Price Accuracy: 99.5% match with original listings
- Specification Accuracy: 99.2% correct vehicle details
- Quality Data: 100% accurate inspection scores
- Location Accuracy: 99.8% precise geographic data
- Image Availability: 98.5% of listings include images
What data fields are available?
Available Fields
| Category | Fields | Description |
|---|---|---|
| Basic Info | 15+ fields | Title, brand, model, year, price |
| Specifications | 20+ fields | Engine, transmission, mileage, color |
| Quality Data | 10+ fields | Inspection scores, ratings, reports |
| Location | 8+ fields | City, state, dealer, delivery info |
| Pricing | 12+ fields | Fixed price, EMI, down payment |
| Financing | 8+ fields | Loan options, interest rates, tenure |
Do you provide historical data?
Historical Data
- Available Period: Up to 12 months of historical data
- Data Points: Price changes, quality updates, market trends
- Export Format: JSON, CSV, Excel
- Access: Available on Pro and Enterprise plans
- Use Cases: Market analysis, trend identification, quality tracking
How do you handle quality assurance data?
Quality Data
- 140-Point Inspection: Complete inspection checklist data
- Quality Ratings: Excellent, Good, Fair classifications
- Inspection Scores: Numerical scores (0-100)
- Service History: Complete maintenance records
- Warranty Information: Warranty coverage and terms
Can I get data for specific cities only?
City Filtering
- Covered Cities: 15+ major Indian cities
- City-Specific Data: Filter by any Spinny service city
- Regional Analysis: Market data by city and state
- Expansion Tracking: Monitor new city launches
- Delivery Coverage: Home delivery availability by city
💰 Pricing & Billing Questions
How much does Spinny API cost?
Pricing Plans
| Plan | Monthly Cost | Requests/Day | Features |
|---|---|---|---|
| Free | $0 | 1,000 | Basic API access |
| Pro | $99 | 10,000 | Full API + historical data |
| Enterprise | Custom | Unlimited | Custom solutions |
What's included in the free plan?
Free Plan Features
- 1,000 requests/day - Sufficient for testing and small projects
- All API endpoints - Full access to search and vehicle data
- Quality data - Inspection scores and ratings
- Basic support - Email support for technical issues
- No credit card required - Start immediately
How do I upgrade my plan?
Plan Upgrade
- Log in to Carapis Dashboard
- Go to Billing section
- Select new plan and payment method
- Confirm upgrade - changes apply immediately
- No downtime - seamless transition between plans
Do you offer refunds?
Refund Policy
- 30-day guarantee - Full refund if not satisfied
- Pro-rated refunds - For unused portion of paid plans
- No questions asked - Simple refund process
- Contact support - Email us for refund requests
Are there any hidden fees?
Transparent Pricing
- No setup fees - Start using immediately
- No overage charges - Requests stop at limit
- No data export fees - Included in plan
- No API call fees - Pay only for plan, not usage
- Clear billing - Monthly invoices with detailed breakdown
🏪 Market & India Questions
How big is the Indian used car market?
Market Size
- Total Listings: 50,000+ quality-assured vehicles on Spinny
- Monthly Transactions: 8,000+ vehicles sold
- Market Value: 45+ billion INR annually
- Geographic Coverage: 15+ major Indian cities
- Market Growth: 15.5% YoY growth rate
What are the most popular car brands in India?
Popular Brands
| Rank | Brand | Market Share | Popular Models |
|---|---|---|---|
| 1 | Maruti Suzuki | 30.8% | Swift, Dzire, Brezza |
| 2 | Hyundai | 25.7% | i20, Verna, Creta |
| 3 | Honda | 16.5% | City, Amaze, WR-V |
| 4 | Toyota | 12.5% | Innova, Fortuner, Camry |
| 5 | Mahindra | 6.4% | XUV300, Scorpio, Bolero |
How do prices compare across different cities?
Regional Price Comparison
| City | Avg Price (INR) | Price Level | Popular Segments |
|---|---|---|---|
| Mumbai | 950,000 | High | Premium, Luxury |
| Delhi NCR | 880,000 | Medium | Mid-range, Economy |
| Bangalore | 920,000 | High | Premium, Tech-focused |
| Hyderabad | 850,000 | Medium | Mid-range, Family |
| Chennai | 820,000 | Medium | Economy, Practical |
What's the typical used car buying process in India?
Indian Market
- Quality Focus: 89.5% prioritize quality over price
- Financing: 68.5% of buyers use EMI options
- Down Payment: Average 20-25% of vehicle price
- Home Delivery: 73.2% choose doorstep delivery
- Digital Process: 94.2% complete process online
How reliable is Spinny as a data source?
Data Reliability
- Market Leader: Fastest-growing used car marketplace in India
- Quality Assurance: 140-point inspection for every vehicle
- Transparent Pricing: No-negotiation fixed pricing model
- Verified Data: Data validated through multiple sources
- Real-time Updates: Continuous updates and monitoring
🔧 Troubleshooting
My API requests are failing with 401 errors
Authentication Issues
Problem: Invalid or expired API key Solutions:
- Check your API key format:
spinny_parser_sk_... - Verify key is active in dashboard
- Ensure proper Authorization header format
- Contact support if key appears valid
I'm getting rate limit errors (429)
Rate Limit Solutions
Problem: Exceeded daily or per-minute limits Solutions:
- Check your current usage in dashboard
- Implement exponential backoff in your code
- Upgrade to higher plan if needed
- Optimize requests to reduce frequency
Search results are not returning expected data
Search Optimization
Problem: No results or unexpected results Solutions:
- Check parameter spelling and format
- Use broader search terms initially
- Verify city names are correct
- Check API documentation for valid values
- Test with minimal parameters first
Quality data seems inconsistent
Quality Data Issues
Problem: Quality ratings or inspection scores seem wrong Solutions:
- Check data freshness timestamps
- Verify you're using latest API version
- Report specific discrepancies to support
- Use vehicle ID for most accurate data
- Check if inspection was recently updated
How do I handle large datasets efficiently?
Performance Tips
Problem: Slow performance with large requests Solutions:
- Use pagination (limit parameter)
- Implement caching for repeated requests
- Use specific filters to reduce results
- Consider batch processing for multiple vehicles
- Use async/await for concurrent requests
📞 Support & Contact
How do I get technical support?
Support Channels
- Email: support@carapis.com
- Documentation: Complete API docs
- Community: Developer forum
- Status Page: API status
- Response Time: Within 24 hours for all inquiries
Can I request custom features or data?
Custom Requests
- Enterprise Plans: Full custom development support
- Feature Requests: Submit via support email
- Data Customization: Available for Pro+ plans
- Integration Support: Technical assistance included
- Priority Support: Dedicated account manager for Enterprise
Do you provide consulting services?
Consulting Services
- Market Analysis: Custom reports and insights
- Integration Support: Technical implementation assistance
- Data Strategy: Best practices and optimization
- Training: API usage and best practices
- Custom Development: Tailored solutions for Enterprise clients
Still have questions? Contact our support team or check our comprehensive documentation for more detailed information.