{
  "specVersion": "1.0",
  "host": {
    "displayName": "EDDM2GO",
    "identifier": "did:web:www.eddm2go.com",
    "description": "EDDM2GO prints and mails USPS Every Door Direct Mail (EDDM) campaigns for local businesses nationwide: pick carrier routes on a live map, see the full price before giving contact details, approve a proof, and EDDM2GO prints, bundles by route and delivers to USPS. Independent printer and mailer, not affiliated with USPS.",
    "url": "https://www.eddm2go.com/",
    "documentationUrl": "https://www.eddm2go.com/llms.txt",
    "contact": "cs@eddm2go.com"
  },
  "entries": [
    {
      "identifier": "urn:air:eddm2go.com:api:zip-profile",
      "displayName": "ZIP code demographics and carrier-route summary",
      "description": "Census ACS 5-year demographics (income, age, homeowners, households, housing, businesses) and the USPS carrier-route summary for one 5-digit U.S. ZIP code. Read-only, no key. Figures are survey estimates with margins of error.",
      "type": "application/json",
      "method": "GET",
      "url": "https://www.eddm2go.com/api/zip-data/{zip}",
      "parameters": { "zip": "5-digit U.S. ZIP code, e.g. 77494" },
      "humanUrl": "https://www.eddm2go.com/zip-code-data/{zip}",
      "representativeQueries": [
        "Median household income in ZIP 77494",
        "How many households and homeowners are in a ZIP code",
        "Demographics of a ZIP code before a direct mail campaign"
      ]
    },
    {
      "identifier": "urn:air:eddm2go.com:api:zip-routes",
      "displayName": "USPS carrier routes in a ZIP code",
      "description": "Every USPS carrier route in a ZIP with current residential and business mailbox counts and EDDM2GO's estimated household profile per route (income, homeowners, families with kids, new movers). Read-only, no key.",
      "type": "application/json",
      "method": "GET",
      "url": "https://www.eddm2go.com/api/zip-data/{zip}/routes",
      "parameters": { "zip": "5-digit U.S. ZIP code" },
      "humanUrl": "https://www.eddm2go.com/zip-code-data/{zip}#routes",
      "representativeQueries": [
        "List the EDDM carrier routes in ZIP 77441 with mailbox counts",
        "Which carrier routes in a ZIP have the highest income",
        "How many homes are on each USPS route in a ZIP"
      ]
    },
    {
      "identifier": "urn:air:eddm2go.com:api:route-profile",
      "displayName": "One carrier route's profile",
      "description": "Mailbox counts, estimated demographics, neighbouring routes and comparison with the ZIP, city and state for a single USPS carrier route (e.g. C001, R011). Read-only, no key.",
      "type": "application/json",
      "method": "GET",
      "url": "https://www.eddm2go.com/api/zip-data/{zip}/routes/{route}",
      "parameters": { "zip": "5-digit U.S. ZIP code", "route": "carrier route id, lower case, e.g. c001 or r011" },
      "humanUrl": "https://www.eddm2go.com/zip-code-data/{zip}/routes/{route}",
      "representativeQueries": [
        "Who lives on carrier route R011 in 77441",
        "Homes and businesses on a USPS carrier route"
      ]
    },
    {
      "identifier": "urn:air:eddm2go.com:api:zip-search",
      "displayName": "ZIP code and city lookup",
      "description": "Find ZIP codes and cities by name or number; returns ZIPs with their mailing city and population, and cities with their ZIP list. Read-only, no key.",
      "type": "application/json",
      "method": "GET",
      "url": "https://www.eddm2go.com/api/zip-data/search?q={query}",
      "parameters": { "query": "a city name or the start of a ZIP code, e.g. katy" },
      "representativeQueries": [
        "Which ZIP codes are in Katy, TX",
        "Find the ZIP code for a city"
      ]
    },
    {
      "identifier": "urn:air:eddm2go.com:api:eddm-price",
      "displayName": "EDDM price for a quantity",
      "description": "Current EDDM2GO prices for a quantity: Full Service (printing, mailing service and USPS postage) and Print Only, total and per piece, from the same pricing the checkout uses. Sales tax (8.25%) is added at checkout and does not apply to postage. Read-only, no key.",
      "type": "application/json",
      "method": "GET",
      "url": "https://www.eddm2go.com/api/quote/anchors?type=postcard&size={size}&qty={qty}",
      "parameters": { "size": "EDDM postcard size: 6.5x9, 6.25x9, 4.5x12, 8.5x11 or 9x12", "qty": "number of pieces (homes), e.g. 5000" },
      "representativeQueries": [
        "How much does an EDDM mailing to 5,000 homes cost",
        "EDDM postcard price per piece including postage"
      ]
    },
    {
      "identifier": "urn:air:eddm2go.com:data:price-list",
      "displayName": "EDDM price list",
      "description": "Every EDDM size and quantity tier with Full Service and Print Only prices, refreshed daily.",
      "type": "application/json",
      "method": "GET",
      "url": "https://www.eddm2go.com/prices.json",
      "alternates": [{ "type": "text/markdown", "url": "https://www.eddm2go.com/pricing.md" }],
      "representativeQueries": [
        "EDDM2GO price list",
        "Compare EDDM postcard sizes and prices"
      ]
    },
    {
      "identifier": "urn:air:eddm2go.com:app:route-map",
      "displayName": "EDDM route map (for people)",
      "description": "Interactive USPS carrier-route map: search a ZIP or address, filter routes by income, homeowners and age, select routes and see the full price. Hand a person this link to plan and order a mailing.",
      "type": "text/html",
      "url": "https://www.eddm2go.com/eddm/select-routes?zip={zip}",
      "parameters": { "zip": "optional 5-digit ZIP to open" },
      "representativeQueries": [
        "Plan an Every Door Direct Mail campaign on a map",
        "Pick EDDM carrier routes near me"
      ]
    },
    {
      "identifier": "urn:air:eddm2go.com:app:file-checker",
      "displayName": "Free EDDM file checker (for people)",
      "description": "Upload a postcard design to check EDDM size, bleed, resolution and indicia placement before printing.",
      "type": "text/html",
      "url": "https://www.eddm2go.com/eddm-file-checker",
      "representativeQueries": [
        "Check my EDDM postcard file before printing",
        "Is my postcard artwork print ready for EDDM"
      ]
    },
    {
      "identifier": "urn:air:eddm2go.com:doc:llms",
      "displayName": "Site overview for AI assistants",
      "description": "What EDDM2GO does, key facts (postage, tax, sizes, turnaround) and links to every main page.",
      "type": "text/plain",
      "url": "https://www.eddm2go.com/llms.txt"
    }
  ],
  "usage": "Public read-only endpoints; please keep to a few requests per second. Figures are Census survey estimates and EDDM2GO modeled route estimates; mailbox counts are USPS EDDM data. Prices are current but the checkout price is authoritative."
}