Revaluator API Documentation

📜 API Rules & Technical Limits

🔎 Purpose: This API allows authorized clients to retrieve high-resolution parcel images and associated property cards by geographic coordinates or parcel identifiers. It is designed for secure, read-only data access in mapping and property evaluation systems.
🔐 Authentication: All secured endpoints require a valid JWT access token issued by /token. This must be passed as a Bearer token in the Authorization header.
⏳ Access Token Lifespan: The JWT issued from /token is valid for 1 hour.
🧾 Signed Asset Token Lifespan:
- Signed URLs for images and PDFs are stateless and valid for 5 minutes.
- Each URL is cryptographically signed and expires after that window.
📸 Image Resizing Rules:
- Optionally specify width and/or height when calling the /images or /images/byparcel endpoints.
- If one dimension is specified, the other is auto-calculated to preserve aspect ratio.
- If both are specified, the image will be resized directly (aspect ratio may be distorted).
- If neither is specified, the full-resolution image is returned (if within limits).
- Max Output Limit: Images are capped to 3840x2160 (4K). Any request above this is proportionally scaled down.
🔁 Signed URL Uniqueness:
- Each combination of image ID, requested dimensions, and requesting user identity results in a unique signed URL.
- Requesting the same image at different sizes will generate different URLs.
📈 Rate Limits: Clients are limited to 300 requests per minute per IP. Exceeding this will result in an HTTP 429 response.
🧠 Stateless Design: All endpoints operate statelessly. No session is maintained between calls.
📍 API Root Endpoint: https://api.revaluator.io

📄 Terms of Service

By using the Revaluator API, you agree to the following terms:

Data Accuracy: Revaluator provides data as-is without guarantees on accuracy or completeness.
Security: Keep your API credentials secure. Revaluator is not responsible for misuse resulting from compromised keys.
Termination: Revaluator may revoke access at any time for abuse, excessive usage, or violation of these terms.
Changes: Terms may be updated at any time. Continued usage constitutes acceptance of revised terms.
Fair Use: The API must not be used to develop or train AI models, scrape, index, or harvest data at scale without explicit permission.
No Warranties: The API is provided "as-is" and "as-available" without warranty of any kind, express or implied.
Limitation of Liability: In no event shall Revaluator be liable for any damages, including but not limited to loss of data, business interruption, or loss of profits arising from the use or inability to use the API.
Indemnification: You agree to indemnify and hold harmless Revaluator LLC from any claims, damages, losses, liabilities, or expenses arising from your use of the API or violation of these terms.
Prohibited Uses: You may not use the API for illegal, harmful, fraudulent, or malicious purposes, including but not limited to harassment, defamation, or unauthorized surveillance.
Jurisdiction: These terms shall be governed by and construed in accordance with the laws of the State of South Carolina, and you consent to the exclusive jurisdiction of its courts.

If you have questions about these terms, please contact us at info@revaluator.io.

Step 1: Get a Token

Send your APIKey and APISecret to the /token endpoint:

JavaScript

C#

Python

fetch("https://api.revaluator.io/token", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    apiKey: "YOUR-KEY-HERE",
    apiSecret: "YOUR-SECRET-HERE"
  })
})
.then(res => res.json())
.then(data => console.log(data.access_token));

var client = new HttpClient();
var content = new StringContent(JsonConvert.SerializeObject(new {
    apiKey = "YOUR-KEY-HERE",
    apiSecret = "YOUR-SECRET-HERE"
}), Encoding.UTF8, "application/json");

var response = await client.PostAsync("https://api.revaluator.io/token", content);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);

import requests

payload = {
  "apiKey": "YOUR-KEY-HERE",
  "apiSecret": "YOUR-SECRET-HERE"
}

response = requests.post("https://api.revaluator.io/token", json=payload)
print(response.json())

✅ Example Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI..."
}

Step 2: Get Images by Coordinates

Use your token to request parcel images near a latitude and longitude.
Optionally, include width and/or height to resize images.
Example:
/images?lat=35.7796&lon=-78.6382&width=600

JavaScript

C#

Python

fetch("https://api.revaluator.io/images?lat=35.7796&lon=-78.6382", {
  headers: {
    "Authorization": "Bearer YOUR_JWT_TOKEN"
  }
})
.then(res => res.json())
.then(data => console.log(data));

var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = 
    new AuthenticationHeaderValue("Bearer", "YOUR_JWT_TOKEN");

var response = await client.GetAsync("https://api.revaluator.io/images?lat=35.7796&lon=-78.6382");
var json = await response.Content.ReadAsStringAsync();
Console.WriteLine(json);

import requests

headers = {
  "Authorization": "Bearer YOUR_JWT_TOKEN"
}

response = requests.get("https://api.revaluator.io/images?lat=35.7796&lon=-78.6382", headers=headers)
print(response.json())

✅ Example Response

{
  "message": "Images retrieved.",
  "fileCount": 2,
  "parcel": "12345",
  "state": "NC",
  "county": "Wake",
  "lat": 35.7796,
  "lon": -78.6382,
  "width": 600,
  "height": 600,
  "tokens": ["..."],
  "urls": ["https://api.revaluator.io/secure-image/...", "..."]
}

Step 3: Get Images by Parcel Number

Retrieve images using known parcel data. Optionally include width/height:
/images/byparcel?parcelNumber=12345&county=Wake&stateCode=NC&width=600

JavaScript

C#

Python

fetch("https://api.revaluator.io/images/byparcel?parcelNumber=12345&county=Wake&stateCode=NC", {
  headers: {
    "Authorization": "Bearer YOUR_JWT_TOKEN"
  }
})
.then(res => res.json())
.then(data => console.log(data));

var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "YOUR_JWT_TOKEN");

var url = "https://api.revaluator.io/images/byparcel?parcelNumber=12345&county=Wake&stateCode=NC";
var response = await client.GetAsync(url);
var json = await response.Content.ReadAsStringAsync();
Console.WriteLine(json);

import requests

headers = {
  "Authorization": "Bearer YOUR_JWT_TOKEN"
}

url = "https://api.revaluator.io/images/byparcel?parcelNumber=12345&county=Wake&stateCode=NC"
response = requests.get(url, headers=headers)
print(response.json())

✅ Example Response

{
  "message": "Images retrieved.",
  "fileCount": 2,
  "parcel": "12345",
  "state": "NC",
  "county": "Wake",
  "lat": 35.7796,
  "lon": -78.6382,
  "width": 600,
  "height": 600,
  "tokens": ["..."],
  "urls": ["https://api.revaluator.io/secure-image/..."]
}

Step 4: View Signed Images

The image URLs returned from the API are signed with short-lived JWT tokens (5 minutes).
Each image URL includes a token unique to the image ID, user identity, and requested size.
Important: If you request the same image at different sizes, different signed URLs will be returned.

<img src="https://api.revaluator.io/secure-image/..." />

Step 5: Get Parcel Card (PDF)

Retrieve a signed PDF parcel card:
/parcelcard?parcelNumber=12345&county=Wake&stateCode=NC

JavaScript

C#

Python

fetch("https://api.revaluator.io/parcelcard?parcelNumber=12345&county=Wake&stateCode=NC", {
  headers: {
    "Authorization": "Bearer YOUR_JWT_TOKEN"
  }
})
.then(res => res.json())
.then(data => console.log(data));

var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "YOUR_JWT_TOKEN");

var url = "https://api.revaluator.io/parcelcard?parcelNumber=12345&county=Wake&stateCode=NC";
var response = await client.GetAsync(url);
var json = await response.Content.ReadAsStringAsync();
Console.WriteLine(json);

import requests

headers = {
  "Authorization": "Bearer YOUR_JWT_TOKEN"
}

url = "https://api.revaluator.io/parcelcard?parcelNumber=12345&county=Wake&stateCode=NC"
response = requests.get(url, headers=headers)
print(response.json())

✅ Example Response

{
  "message": "Card markup retrieved.",
  "fileCount": 1,
  "parcel": "12345",
  "state": "NC",
  "county": "Wake",
  "tokens": ["..."],
  "urls": ["https://api.revaluator.io/secure-card/..."]
}

Step 6: View Signed Parcel Cards

The URLs from the parcelcard response are signed and expire in 5 minutes.
You can embed the PDF directly in your application:

<iframe src="https://api.revaluator.io/secure-card/..." width="100%" height="600"></iframe>

Revaluator API v1.0

📜 API Rules & Technical Limits

📄 Terms of Service

Step 1: Get a Token

✅ Example Response

Step 2: Get Images by Coordinates

✅ Example Response

Step 3: Get Images by Parcel Number

✅ Example Response

Step 4: View Signed Images

Step 5: Get Parcel Card (PDF)

✅ Example Response

Step 6: View Signed Parcel Cards