페이지가 로드되었습니다

API 문서

RealtyAPI의 부동산 데이터를 귀하의 애플리케이션에 통합하세요.

Quick Start Guide

Get up and running with RealtyAPI in minutes.

1. Base URL

https://api.realtyapi.com/v1

2. Authentication

RealtyAPI uses API keys for authentication. Include your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

3. Make your first request

curl -X GET "https://api.realtyapi.com/v1/complexes/search?region=gangnam" \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limiting

Understand API usage limits and how to handle rate limits.

Request Limits

Free Tier
100/min

100 requests per minute

Pro Tier
1000/min

1000 requests per minute

Response Headers

Every API response includes rate limit information in the headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640995200

Handling Rate Limits

When you exceed the rate limit, you'll receive a 429 Too Many Requests response:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please retry after 60 seconds.",
  "retry_after": 60
}

Best Practice: Implement exponential backoff when retrying failed requests.