{"id":"regional-economy-brief","title":"Regional Economy & Trade Brief","description":"Given a US state, county or metro (name, FIPS or CBSA), an industry (NAICS code or description) and a role (retailer, logistics, cfo, lender, other), reads BLS LAUS and QCEW, FRED (state employment, house prices, goods exports and imports, regional CPI), Census Building Permits and USAspending live, then computes levels, year-over-year and three-year changes, location quotient, z-scores against the national series, trend direction with a stated threshold and data freshness. Each indicator carries value, period, source URL and fetch time. A short business brief for the role is written from the computed table only; any statement with a number not in the table, or forward-looking wording, is dropped and listed. Returns INSUFFICIENT_DATA when too few series resolve, and lists what was not checked (Census ACS/CBP/trade APIs need a key). Descriptive analysis, not a forecast or financial advice.","roi":"A sourced, dated local-conditions table (jobs, wages, housing, permits, trade, federal spending, industry concentration) plus a role-specific brief whose every number is checked against that table, replacing an hour of pulling BLS, Census and FRED series by hand.","audience":"business","channels":["x402","mcp","rapidapi","apify"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/regional-economy","path":"/api/v1/regional-economy","contentType":"application/json"},"price":{"amount":"0.75","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["region","industry","role"],"properties":{"region":{"type":"string","minLength":2,"maxLength":120,"description":"A US state, county or metropolitan area by name (\"Ohio\", \"Travis County, TX\", \"Phoenix metro\"), state FIPS (39), county FIPS (48453) or metro CBSA code (38060)."},"regionType":{"type":"string","enum":["state","county","metro"],"description":"Disambiguates a name that is both a county and a metro or state."},"industry":{"type":"string","minLength":2,"maxLength":200,"description":"NAICS code (44-45, 722, 4841) or a plain description (\"restaurants\", \"trucking\")."},"role":{"type":"string","enum":["retailer","logistics","cfo","lender","other"],"description":"Who the brief is for."},"lookbackYears":{"type":"integer","minimum":1,"maximum":10,"description":"Years of history used for z-scores (default 5)."}}},"resultSchema":{"type":"object","properties":{"status":{"type":"string","enum":["OK","PARTIAL","INSUFFICIENT_DATA"],"description":"INSUFFICIENT_DATA: too few series resolved to write a brief. PARTIAL: indicators only (brief failed or every statement failed verification)."},"reason":{"type":"string"},"region":{"type":"object"},"industry":{"anyOf":[{"type":"object"},{"type":"null"}]},"role":{"type":"string","enum":["retailer","logistics","cfo","lender","other"]},"lookback_years":{"type":"integer"},"as_of":{"type":"string"},"brief":{"anyOf":[{"type":"null"},{"type":"object","properties":{"summary":{"type":"string"},"findings":{"type":"array","items":{"type":"object","properties":{"statement":{"type":"string"},"indicator_ids":{"type":"array","items":{"type":"string"}}}}},"role_implications":{"type":"array","items":{"type":"object","properties":{"statement":{"type":"string"},"indicator_ids":{"type":"array","items":{"type":"string"}}}}},"watch_items":{"type":"array","items":{"type":"object","properties":{"statement":{"type":"string"},"indicator_ids":{"type":"array","items":{"type":"string"}}}}},"caveats":{"type":"array","items":{"type":"string"}}}}],"description":"Every number in the brief appears in the indicator table."},"dropped_claims":{"type":"array","items":{"type":"object"},"description":"Model statements removed by verification, with the reason."},"indicators":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"scope":{"type":"string","enum":["area","state","region","nation"]},"unit":{"type":"string"},"value":{"type":"number"},"period":{"type":"string"},"prior_year_value":{"anyOf":[{"type":"number"},{"type":"null"}]},"yoy_change":{"anyOf":[{"type":"number"},{"type":"null"}]},"yoy_pct":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_3y":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_3y_pct":{"anyOf":[{"type":"number"},{"type":"null"}]},"z_vs_national":{"anyOf":[{"type":"number"},{"type":"null"}]},"location_quotient":{"anyOf":[{"type":"number"},{"type":"null"}]},"trend":{"anyOf":[{"type":"string","enum":["up","down","flat"]},{"type":"null"}]},"reading":{"anyOf":[{"type":"string"},{"type":"null"}]},"age_months":{"type":"integer"},"stale":{"type":"boolean"},"source":{"type":"string"},"source_url":{"type":"string"},"fetched_at":{"type":"string"},"facts":{"type":"string"}}}},"data_gaps":{"type":"array","items":{"type":"object"}},"stale_indicators":{"type":"array","items":{"type":"string"}},"not_checked":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"reason":{"type":"string"}}}},"methodology":{"type":"object"},"warnings":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string"}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["OK","PARTIAL","INSUFFICIENT_DATA"],"description":"INSUFFICIENT_DATA: too few series resolved to write a brief. PARTIAL: indicators only (brief failed or every statement failed verification)."},"reason":{"type":"string"},"region":{"type":"object"},"industry":{"anyOf":[{"type":"object"},{"type":"null"}]},"role":{"type":"string","enum":["retailer","logistics","cfo","lender","other"]},"lookback_years":{"type":"integer"},"as_of":{"type":"string"},"brief":{"anyOf":[{"type":"null"},{"type":"object","properties":{"summary":{"type":"string"},"findings":{"type":"array","items":{"type":"object","properties":{"statement":{"type":"string"},"indicator_ids":{"type":"array","items":{"type":"string"}}}}},"role_implications":{"type":"array","items":{"type":"object","properties":{"statement":{"type":"string"},"indicator_ids":{"type":"array","items":{"type":"string"}}}}},"watch_items":{"type":"array","items":{"type":"object","properties":{"statement":{"type":"string"},"indicator_ids":{"type":"array","items":{"type":"string"}}}}},"caveats":{"type":"array","items":{"type":"string"}}}}],"description":"Every number in the brief appears in the indicator table."},"dropped_claims":{"type":"array","items":{"type":"object"},"description":"Model statements removed by verification, with the reason."},"indicators":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"scope":{"type":"string","enum":["area","state","region","nation"]},"unit":{"type":"string"},"value":{"type":"number"},"period":{"type":"string"},"prior_year_value":{"anyOf":[{"type":"number"},{"type":"null"}]},"yoy_change":{"anyOf":[{"type":"number"},{"type":"null"}]},"yoy_pct":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_3y":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_3y_pct":{"anyOf":[{"type":"number"},{"type":"null"}]},"z_vs_national":{"anyOf":[{"type":"number"},{"type":"null"}]},"location_quotient":{"anyOf":[{"type":"number"},{"type":"null"}]},"trend":{"anyOf":[{"type":"string","enum":["up","down","flat"]},{"type":"null"}]},"reading":{"anyOf":[{"type":"string"},{"type":"null"}]},"age_months":{"type":"integer"},"stale":{"type":"boolean"},"source":{"type":"string"},"source_url":{"type":"string"},"fetched_at":{"type":"string"},"facts":{"type":"string"}}}},"data_gaps":{"type":"array","items":{"type":"object"}},"stale_indicators":{"type":"array","items":{"type":"string"}},"not_checked":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"reason":{"type":"string"}}}},"methodology":{"type":"object"},"warnings":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"region":"Travis County, TX","industry":"restaurants","role":"lender","lookbackYears":5},"openapiOperation":{"operationId":"regional_economy_brief","summary":"Regional Economy & Trade Brief","description":"Given a US state, county or metro (name, FIPS or CBSA), an industry (NAICS code or description) and a role (retailer, logistics, cfo, lender, other), reads BLS LAUS and QCEW, FRED (state employment, house prices, goods exports and imports, regional CPI), Census Building Permits and USAspending live, then computes levels, year-over-year and three-year changes, location quotient, z-scores against the national series, trend direction with a stated threshold and data freshness. Each indicator carries value, period, source URL and fetch time. A short business brief for the role is written from the computed table only; any statement with a number not in the table, or forward-looking wording, is dropped and listed. Returns INSUFFICIENT_DATA when too few series resolve, and lists what was not checked (Census ACS/CBP/trade APIs need a key). Descriptive analysis, not a forecast or financial advice.\n\nPrice: 0.75 USDC on Base (x402).","x-x402-price-usdc":"0.75","x-x402-amount":"750000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.75"}},"x-audience":"business","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/regional-economy-brief","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["region","industry","role"],"properties":{"region":{"type":"string","minLength":2,"maxLength":120,"description":"A US state, county or metropolitan area by name (\"Ohio\", \"Travis County, TX\", \"Phoenix metro\"), state FIPS (39), county FIPS (48453) or metro CBSA code (38060)."},"regionType":{"type":"string","enum":["state","county","metro"],"description":"Disambiguates a name that is both a county and a metro or state."},"industry":{"type":"string","minLength":2,"maxLength":200,"description":"NAICS code (44-45, 722, 4841) or a plain description (\"restaurants\", \"trucking\")."},"role":{"type":"string","enum":["retailer","logistics","cfo","lender","other"],"description":"Who the brief is for."},"lookbackYears":{"type":"integer","minimum":1,"maximum":10,"description":"Years of history used for z-scores (default 5)."}}},"example":{"region":"Travis County, TX","industry":"restaurants","role":"lender","lookbackYears":5}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["OK","PARTIAL","INSUFFICIENT_DATA"],"description":"INSUFFICIENT_DATA: too few series resolved to write a brief. PARTIAL: indicators only (brief failed or every statement failed verification)."},"reason":{"type":"string"},"region":{"type":"object"},"industry":{"anyOf":[{"type":"object"},{"type":"null"}]},"role":{"type":"string","enum":["retailer","logistics","cfo","lender","other"]},"lookback_years":{"type":"integer"},"as_of":{"type":"string"},"brief":{"anyOf":[{"type":"null"},{"type":"object","properties":{"summary":{"type":"string"},"findings":{"type":"array","items":{"type":"object","properties":{"statement":{"type":"string"},"indicator_ids":{"type":"array","items":{"type":"string"}}}}},"role_implications":{"type":"array","items":{"type":"object","properties":{"statement":{"type":"string"},"indicator_ids":{"type":"array","items":{"type":"string"}}}}},"watch_items":{"type":"array","items":{"type":"object","properties":{"statement":{"type":"string"},"indicator_ids":{"type":"array","items":{"type":"string"}}}}},"caveats":{"type":"array","items":{"type":"string"}}}}],"description":"Every number in the brief appears in the indicator table."},"dropped_claims":{"type":"array","items":{"type":"object"},"description":"Model statements removed by verification, with the reason."},"indicators":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"scope":{"type":"string","enum":["area","state","region","nation"]},"unit":{"type":"string"},"value":{"type":"number"},"period":{"type":"string"},"prior_year_value":{"anyOf":[{"type":"number"},{"type":"null"}]},"yoy_change":{"anyOf":[{"type":"number"},{"type":"null"}]},"yoy_pct":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_3y":{"anyOf":[{"type":"number"},{"type":"null"}]},"change_3y_pct":{"anyOf":[{"type":"number"},{"type":"null"}]},"z_vs_national":{"anyOf":[{"type":"number"},{"type":"null"}]},"location_quotient":{"anyOf":[{"type":"number"},{"type":"null"}]},"trend":{"anyOf":[{"type":"string","enum":["up","down","flat"]},{"type":"null"}]},"reading":{"anyOf":[{"type":"string"},{"type":"null"}]},"age_months":{"type":"integer"},"stale":{"type":"boolean"},"source":{"type":"string"},"source_url":{"type":"string"},"fetched_at":{"type":"string"},"facts":{"type":"string"}}}},"data_gaps":{"type":"array","items":{"type":"object"}},"stale_indicators":{"type":"array","items":{"type":"string"}},"not_checked":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"reason":{"type":"string"}}}},"methodology":{"type":"object"},"warnings":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string"}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/regional-economy-brief/","docsJson":"https://agents.writerslogic.com/docs/regional-economy-brief.json","sample":"https://agents.writerslogic.com/api/v1/samples/regional-economy-brief","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}