# RentYard Finder machine-readable feeds
openapi: 3.0.3
info:
  title: RentYard Finder Feeds
  version: "1.0.0"
  description: |
    Static JSON feeds of U.S. equipment rental yard listings compiled from
    OpenStreetMap (ODbL) and Overture Maps Places (CDLA-Permissive-2.0).
    Listings are unverified by default. Do not invent prices, reviews, or stock.
    HTML pages remain free to browse. Bulk/API access may later use Cloudflare
    Pay Per Crawl / Monetization Gateway (x402); see /for-agents/.
  contact:
    name: RentYard Finder
    url: https://rentyardfinder.com/for-agents/
  license:
    name: Mixed — OSM ODbL + Overture CDLA-Permissive-2.0 (see /sources/)
    url: https://rentyardfinder.com/sources/
servers:
  - url: https://rentyardfinder.com
paths:
  /feeds/summary.json:
    get:
      summary: Dataset summary and discovery links
      responses:
        "200":
          description: Summary JSON
  /feeds/states.json:
    get:
      summary: Counts and feed URLs by U.S. state
      responses:
        "200":
          description: States JSON
  /feeds/machines.json:
    get:
      summary: Equipment type hubs (no per-yard stock claims)
      responses:
        "200":
          description: Machines JSON
  /feeds/listings/{state}.json:
    get:
      summary: NAP listings for one state (2-letter code, lowercase)
      parameters:
        - name: state
          in: path
          required: true
          schema:
            type: string
            example: or
      responses:
        "200":
          description: Listings JSON for that state
x-updated: "2026-11-05"
x-llms: https://rentyardfinder.com/llms.txt
x-agent-json: https://rentyardfinder.com/.well-known/agent.json