Developer API & Widget

API Reference

Base URL: https://collectgive.com/api/v1

GET /prices/lookup

Look up the verified price for a specific service in a ZIP code.

Parameter	Type	Description
service required	string	Service name (e.g., "Furnace Replacement")
zip_code required	string	5-digit US ZIP code

curl "https://collectgive.com/api/v1/prices/lookup?service=Furnace+Replacement&zip_code=80202"

Example Response

{
  "found": true,
  "service": "Furnace Replacement",
  "zip_code": "80202",
  "price_average": 6800,
  "price_low": 4800,
  "price_high": 9800,
  "confidence_level": "high",
  "confidence_score": 85.2,
  "data_sources_count": 47,
  "trend_direction": "stable",
  "last_updated": "2026-04-10T12:00:00Z",
  "citation_url": "https://collectgive.com/denver/furnace-replacement?zip=80202",
  "source": "CollectGive Verified Price Index"
}

GET /prices/range

Get prices for multiple services in a ZIP code.

Parameter	Type	Description
zip_code required	string	5-digit US ZIP code
services	string	Comma-separated service names (optional, returns all if omitted)
limit	number	Max results (default: 50, max: 100)

curl "https://collectgive.com/api/v1/prices/range?zip_code=80202"

GET /prices/trend

Get price trend history for a service in a ZIP code. Useful for charts.

Parameter	Type	Description
service required	string	Service name
zip_code required	string	5-digit US ZIP code
days	number	Number of days of history (default: 90)

curl "https://collectgive.com/api/v1/prices/trend?service=Central+AC+Installation&zip_code=80202&days=180"

GET /prices/services

List all available services with current market-level pricing.

curl "https://collectgive.com/api/v1/prices/services"

POST /prices/contribute

Contribute a price observation. Submitted data is reviewed and blended into the CollectGive Price Index.

Field	Type	Description
service required	string	Service name
zip_code required	string	5-digit US ZIP code
amount required	number	Price paid or quoted (USD)
description	string	Additional context
source_url	string	URL where the price was found

curl -X POST "https://collectgive.com/api/v1/prices/contribute" \
  -H "Content-Type: application/json" \
  -d '{"service":"Furnace Replacement","zip_code":"80202","amount":6500,"description":"Standard efficiency furnace"}'

Embeddable Widget

Add a live price badge to your website with two lines of HTML. The widget auto-updates and links back to CollectGive for full pricing details.

Copy & paste into your HTML

<div data-collectgive-widget
     data-service="Furnace Replacement"
     data-zip="80202"></div>
<script src="https://collectgive.com/widget/collectgive.js" async></script>

Widget Attributes

Attribute	Description
data-collectgive-widget	Activates the widget on this element
data-service	Service name (e.g., "Furnace Replacement", "Central AC Installation")
data-zip	5-digit US ZIP code
data-api-key	Optional API key for higher rate limits

Live Preview

Multiple Widgets

You can place multiple widgets on the same page. Each one fetches its own data independently.

<div data-collectgive-widget data-service="Furnace Replacement" data-zip="80202"></div>
<div data-collectgive-widget data-service="Central AC Installation" data-zip="80202"></div>
<div data-collectgive-widget data-service="Heat Pump Installation" data-zip="80202"></div>
<script src="https://collectgive.com/widget/collectgive.js" async></script>

API Keys

No API key is required for read access. Register a free key for higher rate limits (300 req/min vs 60) and usage tracking.

POST /register

Register for a free API key.

curl -X POST "https://collectgive.com/api/v1/register" \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","name":"Your App","website":"https://yoursite.com"}'

Example Response

{
  "success": true,
  "api_key": "cg_a1b2c3d4e5f6...",
  "rate_limit": "300 requests/minute",
  "usage": "Include as X-Api-Key header or api_key query parameter",
  "docs": "https://collectgive.com/developers"
}

Using Your API Key

// As a header (recommended)
curl -H "X-Api-Key: cg_your_key_here" \
  "https://collectgive.com/api/v1/prices/lookup?service=Furnace+Replacement&zip_code=80202"

// As a query parameter
curl "https://collectgive.com/api/v1/prices/lookup?service=Furnace+Replacement&zip_code=80202&api_key=cg_your_key_here"

Rate Limits

Anonymous

60 requests/minute per IP

With API Key

300 requests/minute per key

Rate limit headers are included in every response: X-RateLimit-Limit and X-RateLimit-Remaining.

Attribution Guidelines

When displaying CollectGive data, please include attribution that links back to collectgive.com. This helps us keep the API free for everyone.

Recommended Attribution

Include one of the following on any page that displays CollectGive data:

"Pricing data from CollectGive"
"Source: CollectGive Verified Price Index"
Use the embeddable widget (attribution is built in)

Every API response includes a citation_url field — use it as the link target for attribution.

Questions?

The API is free to use. Every query helps strengthen the CollectGive Price Index.
$5 from every verified home service request is donated to a verified nonprofit.

api@collectgive.com

CollectGive Developer API