autobodyshop-api 0.1.0

Zero-dependency client for the Auto Body Shop Directory public API - find US auto body shops by ZIP code, city, location, or shop profile (autobodyshopnear.com).

autobodyshop-api

Zero-dependency Python client for the Auto Body Shop Directory public API — find US auto body shops, collision centers, and paint shops by ZIP code, city, location, or shop profile.

Powered by AutoBodyShopNear.com, a directory of 80,000+ US auto body shops.

• No API key required — the public API is free to use
• Zero dependencies — standard library only (Python 3.8+)

Install

pip install autobodyshop-api

Usage

from autobodyshop_api import AutoBodyShopClient

client = AutoBodyShopClient()

# Find shops in a ZIP code
by_zip = client.shops_by_zip("77056")
print(by_zip["items"])

# Find shops in a city
by_city = client.shops_by_city("Houston", state="TX", limit=10)

# Find shops near a location
nearby = client.shops_nearby(29.7604, -95.3698, radius_miles=25)

# Fetch one shop's profile by slug
shop = client.shop_by_slug("champion-auto-parts-houston-tx-77056")
print(shop["name"], shop["profileUrl"])

Pagination

List endpoints accept limit (1–100, default 20) and offset, and return items, limit, offset, total, and hasMore:

offset, all_shops = 0, []
while True:
    page = client.shops_by_city("Houston", state="TX", limit=100, offset=offset)
    all_shops.extend(page["items"])
    if not page["hasMore"]:
        break
    offset += page["limit"]

Error handling

Failed requests raise AutoBodyShopApiError with status (HTTP status) and code (e.g. VALIDATION_ERROR, NOT_FOUND):

from autobodyshop_api import AutoBodyShopApiError

try:
    client.shop_by_slug("does-not-exist")
except AutoBodyShopApiError as err:
    print(err.code, err.status, err)

API reference

Method	Endpoint	Description
index()	GET /	API metadata and endpoint index
shops_by_zip(zip_code, ...)	GET /shops/by-zip	Shops in a 5-digit ZIP code
shops_by_city(city, state=None, ...)	GET /shops/by-city	Shops in a city (optional state)
shops_nearby(lat, lng, radius_miles=None, ...)	GET /shops/nearby	Shops near a lat/lng (radius 1–200 miles)
shop_by_slug(slug)	GET /shops/{slug}	Single shop profile

Full API documentation: autobodyshopnear.com/developers/body-shop-api OpenAPI spec: openapi.json

Links

• Website: autobodyshopnear.com
• Terms of service: autobodyshopnear.com/terms-of-service
• Node.js client: autobodyshop-api on npm

License

MIT