{
  "meta": {
    "generated_at": "2026-06-16T20:21:25.026Z"
  },
  "profile": {
    "schema_version": "2026-06-01",
    "source_identity": {
      "slug": "us-census-bureau",
      "name": "US Census Bureau",
      "homepage": "https://www.census.gov/data.html",
      "root_domains": [
        "www.census.gov",
        "api.census.gov"
      ],
      "provider_type": "Governmental",
      "tags": [
        "economics",
        "population"
      ],
      "geo_region": "north_america"
    },
    "access_profile": {
      "access_level": "open",
      "access_type": "open",
      "cost": "free",
      "auth_required": false,
      "auth_type": "optional_api_key",
      "data_access_report": {
        "active_tracking": true,
        "exportable_data": "public_api",
        "free_api": true,
        "collection_method": "rest-api-and-catalog",
        "estimated_size": "huge",
        "docker_fit": "docker_ok_with_storage",
        "download_location": "https://api.census.gov/data.json",
        "reason": "Official public API and dataset catalog are available; broad pulls need storage."
      },
      "terms_caveat": "Verify provider terms before production reuse."
    },
    "collection_profile": {
      "collection_level": "L2",
      "methods": [
        "api",
        "bulk-export",
        "csv",
        "direct-link",
        "end-user",
        "other",
        "pdf",
        "portal",
        "rest-api-and-catalog",
        "xlsx"
      ],
      "active_tracking": true,
      "exportable_data": "public_api",
      "docker_fit": "docker_ok_with_storage",
      "estimated_size": "huge",
      "download_location": "https://api.census.gov/data.json",
      "page_type": "portal+rest-api",
      "public_dataset_examples": [
        "https://api.census.gov/data.json"
      ],
      "known_datasets": [
        "Decennial Census",
        "P1TOTAL POPULATION",
        "American Community Survey",
        "S0101Age and Sex",
        "American Community Survey",
        "DP05ACS Demographic and Housing Estimates",
        "American Community Survey",
        "S1901Income in the Past 12 Months (in 2023 Inflation-Adjusted Dollars)",
        "American Community Survey",
        "DP03Selected Economic Characteristics",
        "Decennial Census",
        "P2URBAN AND RURAL",
        "American Community Survey",
        "DP02Selected Social Characteristics in the United States",
        "American Community Survey",
        "DP04Selected Housing Characteristics",
        "American Community Survey",
        "S1701Poverty Status in the Past 12 Months",
        "American Community Survey",
        "S1501Educational Attainment"
      ],
      "recommended_next_action": "Use the documented public content probe, then promote to freshness only after a stable value is confirmed."
    },
    "tracking_profile": {
      "plan_status": "needs-review",
      "liveness_url": "https://www.census.gov/data.html",
      "content_probes": [
        "https://www.census.gov/data.html"
      ],
      "freshness_probe": {
        "url": "https://api.census.gov/data/2023/acs/acs1?get=NAME,B01001_001E&for=us:1",
        "confirmed": false,
        "parse": "json — check HTTP 200 and array length > 1",
        "format": "static year in URL",
        "stale_threshold_days": 365
      },
      "cadence": {
        "liveness": "5 minutes",
        "content": "6 hours",
        "freshness": "not enabled"
      }
    },
    "health_snapshot": {
      "current_liveness": "up",
      "combined": "green",
      "data_status": "ok",
      "last_checked_at": "2026-06-16T18:00:23.241Z",
      "recent_failure_reason": null,
      "recent_probe": {
        "method": "GET",
        "target_label": "candidate data probe",
        "http_status": 200,
        "freshness_value": null
      },
      "recent_events": [
        {
          "source_slug": "us-census-bureau",
          "event_type": "source_restored",
          "details": "{\"http\":200}",
          "detected_at": "2026-06-07T22:05:08.070Z"
        },
        {
          "source_slug": "us-census-bureau",
          "event_type": "source_impacted",
          "details": "{\"reason\":\"timeout\",\"http\":0}",
          "detected_at": "2026-06-07T22:00:10.698Z"
        },
        {
          "source_slug": "us-census-bureau",
          "event_type": "source_restored",
          "details": "{\"http\":200}",
          "detected_at": "2026-06-07T21:55:08.053Z"
        },
        {
          "source_slug": "us-census-bureau",
          "event_type": "source_impacted",
          "details": "{\"reason\":\"timeout\",\"http\":0}",
          "detected_at": "2026-06-07T21:50:08.049Z"
        },
        {
          "source_slug": "us-census-bureau",
          "event_type": "source_restored",
          "details": "{\"http\":200}",
          "detected_at": "2026-06-07T21:10:08.049Z"
        }
      ]
    },
    "llm_guidance": {
      "best_use": "Good candidate for automated data access.",
      "warnings": [
        "Portal at census.gov. REST API at api.census.gov. No key needed for small requests. 12,000+ datasets via api.census.gov/data.json catalog. ACS, Decennial, Economic Surveys etc.",
        "No API key needed for low-volume requests. ACS 1-year 2023 data. Returns 2-element array: headers + data. Year in URL needs updating annually. Better: check census.gov/data.html for latest available year.",
        "Expected content: Census Bureau"
      ],
      "suggested_prompt": "Assess US Census Bureau for a low-cost economic data pipeline. Explain access, collection level, current health, and caveats."
    },
    "attestation": {
      "confidence": "medium",
      "verified_at": null,
      "data_quality": "rough",
      "evidence": {
        "source_page": "/source/us-census-bureau",
        "status_page": "/uptime",
        "plan_status": "needs-review"
      },
      "known_gaps": [
        "Source plan needs review before relying on freshness.",
        "Freshness is not confirmed."
      ]
    }
  }
}