> ## Documentation Index > Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # 市场数据 > 查询美国房产估值、租金估算、房产记录、房源、市场统计和股票报价。 美国房产估值、租金估算、房产记录、出售及出租房源、邮编级市场统计和股票报价。选择操作，并提供地址、城市加州、邮编或股票代码。 所有操作返回规范化 output，以及最后一个 Run 的 id、provider 和生命周期 status。property\_value、property\_rent、market\_stats、stock\_quote 返回固定顶层字段；property\_search、listings\_sale、listings\_rental 返回每行字段固定的 output.items\[]。原生输出不在 output 中重复，保留在 Run 中，可通过 GET /v1/runs/:id 读取。数据提供商未报告的值为 null；房产金额为美元，股票报价包含 currency。 分别检查 result\_status 和 status：前者为 success、no\_result、error 或 pending。charge\_usd 为本响应 runs 总费用，所有 Run 结算前为 null；runs\[] 包含各自费用。指定数据提供商时不切换。对于 QUEUED/RUNNING，即 HTTP 202，在 API 服务地址上使用认证轮询 result\_url。有意重试时复用相同 Idempotency-Key 和执行参数。 ## 各操作输出 各操作的规范化字段。原生输出保留在 Run 中，可通过 GET /v1/runs/:id 读取。未报告的值为 null；有效空结果保留操作结构，各字段为 null 或 items 为 \[]，result\_status 为 no\_result。金额为美元，操作包含 currency 字段时除外。*\_date 为 YYYY-MM-DD，*\_at 为 ISO 8601 UTC，\*\_text 为原样返回的展示文本。 * property\_value: address, property\_type, bedrooms, bathrooms, living\_area\_sqft ，居住面积, lot\_size\_sqft, year\_built, latitude, longitude, estimated\_value\_usd, value\_low\_usd, value\_high\_usd, comparables\_count ，估值所用的可比成交数 * property\_rent: address, property\_type, bedrooms, bathrooms, living\_area\_sqft ，居住面积, lot\_size\_sqft, year\_built, latitude, longitude, estimated\_rent\_usd ，月度, rent\_low\_usd, rent\_high\_usd, comparables\_count ，估算所用的可比租赁数 * property\_search: items\[]: property\_id, address, property\_type, bedrooms, bathrooms, living\_area\_sqft ，居住面积, lot\_size\_sqft, year\_built, latitude, longitude, last\_sale\_price\_usd, last\_sale\_date ，YYYY-MM-DD, owner\_names\[], owner\_type, owner\_mailing\_address, owner\_occupied * listings\_sale: items\[]: listing\_id, address, property\_type, bedrooms, bathrooms, living\_area\_sqft ，居住面积, lot\_size\_sqft, year\_built, latitude, longitude, status, listing\_type, listed\_date ，YYYY-MM-DD, days\_on\_market, hoa\_fee\_usd ，月度 HOA 费用, mls\_name, mls\_number, agent `{name, phone, email, website}`, office `{name, phone, email, website}`, price\_usd ，挂牌价 * listings\_rental: items\[]: listing\_id, address, property\_type, bedrooms, bathrooms, living\_area\_sqft ，居住面积, lot\_size\_sqft, year\_built, latitude, longitude, status, listing\_type, listed\_date ，YYYY-MM-DD, days\_on\_market, hoa\_fee\_usd ，月度 HOA 费用, mls\_name, mls\_number, agent `{name, phone, email, website}`, office `{name, phone, email, website}`, monthly\_rent\_usd * market\_stats: zip, updated\_at ，ISO 8601 UTC，RentCast 最近刷新汇总的时间, sale `{average_price_usd, median_price_usd, average_price_per_sqft_usd, median_price_per_sqft_usd, average_days_on_market, median_days_on_market, total_listings, new_listings}`, rental `{average_rent_usd, median_rent_usd, average_rent_per_sqft_usd, median_rent_per_sqft_usd ，月租金, average_days_on_market, median_days_on_market, total_listings, new_listings}` * stock\_quote: symbol, name, exchange, currency, price ，常规时段最新价格，单位为 currency；Google Finance 报价可能延迟, change ，相对于上一常规收盘价的绝对变动，单位为 currency, change\_percent ，相对于上一常规收盘价的百分点变动，1.5 表示 1.5%, extended\_hours\_session ，原样展示的时段标签，如 Pre-market 或 After hours，常规时段为 null, extended\_hours\_price, extended\_hours\_change、extended\_hours\_change\_percent，盘前盘后报价相对于常规时段价格的变动，单位相同, as\_of\_text ，Google Finance 页面原样时间戳，不是 ISO 格式，也不是 price 的时间 ```json { "action": "property_value", "provider": "rentcast", "status": "COMPLETED", "result_status": "success", "output": { "address": "5500 Grand Lake Dr, San Antonio, TX 78244", "property_type": "Single Family", "bedrooms": 3, "bathrooms": 2, "living_area_sqft": 1878, "lot_size_sqft": 8843, "year_built": 1973, "latitude": 29.476011, "longitude": -98.351454, "estimated_value_usd": 235000, "value_low_usd": 203000, "value_high_usd": 266000, "comparables_count": 15 }, "charge_usd": "0.0814", "runs": [{ "provider": "rentcast", "status": "COMPLETED", "charge_usd": "0.0814" }], "result_url": "/v1/solutions/gtm/market_data/result?token=…" } ``` ## OpenAPI ````yaml /openapi.zh.json post /v1/solutions/gtm/market_data openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: 一个 API Key，无需合同，按次付费，即可调用批量采购的付费 API。每个响应包含 x-request-id；所有错误正文采用统一结构。 servers: - url: https://api.glasser.ai security: [] tags: - name: Solutions - name: Endpoints - name: Runs - name: Balance paths: /v1/solutions/gtm/market_data: post: tags: - Solutions summary: 市场数据 description: >- 美国房产估值、租金估算、房产记录、出售及出租房源、邮编级市场统计和股票报价。选择操作，并提供地址、城市加州、邮编或股票代码。 所有操作返回规范化 output，以及最后一个 Run 的 id、provider 和生命周期 status。property_value、property_rent、market_stats、stock_quote 返回固定顶层字段；property_search、listings_sale、listings_rental 返回每行字段固定的 output.items[]。原生输出不在 output 中重复，保留在 Run 中，可通过 GET /v1/runs/:id 读取。数据提供商未报告的值为 null；房产金额为美元，股票报价包含 currency。 分别检查 result_status 和 status：前者为 success、no_result、error 或 pending。charge_usd 为本响应 runs 总费用，所有 Run 结算前为 null；runs[] 包含各自费用。指定数据提供商时不切换。对于 QUEUED/RUNNING，即 HTTP 202，在 API 服务地址上使用认证轮询 result_url。有意重试时复用相同 Idempotency-Key 和执行参数。 operationId: gtm-market-data parameters: - name: idempotency-key in: header schema: type: string minLength: 1 description: >- 为每次预期执行生成唯一值，推荐使用 UUID。使用同一个键和执行参数重试，可读取原 Run，避免再次扣费。使用同一个键但修改执行参数会返回 409；修改 task_id 或 metadata 不会更新原 Run。 required: true requestBody: content: application/json: schema: type: object properties: action: type: string enum: - property_value - property_rent - property_search - listings_sale - listings_rental - market_stats - stock_quote description: >- 选择要获取的数据： - property_value 或 property_rent：提供 address。 - property_search、listings_sale 或 listings_rental：提供 address、city 加 state，或 zip。 - market_stats：提供 zip。 - stock_quote：提供 symbol。 provider: anyOf: - type: string enum: - auto - rentcast - serpapi description: >- 默认为 auto，按 Glasser 偏好顺序选择第一家符合条件的数据提供商。指定的数据提供商必须支持请求且获得当前 API Key 的允许，不会切换到其他家。可用值见下方。 - type: 'null' address: anyOf: - type: string minLength: 1 maxLength: 300 - type: 'null' city: anyOf: - type: string minLength: 1 maxLength: 100 - type: 'null' state: anyOf: - type: string pattern: ^[A-Za-z]{2}$ - type: 'null' zip: anyOf: - type: string pattern: ^\d{5}$ - type: 'null' symbol: anyOf: - type: string minLength: 1 maxLength: 40 - type: 'null' limit: anyOf: - type: integer minimum: 1 maximum: 100 description: 返回条数。请从较少条数开始：路由到的接口可能据此计费。各能力还会进一步限制上限。 - type: 'null' task_id: anyOf: - type: string description: >- 将相关 Run，包括自动切换产生的 Run，归入同一个 Task。复用稳定字符串，并通过 Task 筛选 Run 列表。 - type: 'null' metadata: anyOf: - anyOf: - type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ - {} description: |- 可选追踪字段，随 Run 返回，也可用于筛选。不会发送给数据提供商，也不影响路由、价格或幂等。 - 最多 20 个键：小写字母、数字和下划线，以字母开头，最长 40 个字符。 - 值：长度为 1–500 的字符串。 - user_id：终端用户的不透明 ID，不得使用邮箱或姓名。 无效条目整体丢弃，不截断。请求继续执行，Run 返回实际保存的字段。 - type: 'null' required: - action additionalProperties: false required: true responses: '200': description: 成功 content: application/json: schema: anyOf: - $ref: '#/components/schemas/MarketDataResult' '202': description: 成功 content: application/json: schema: anyOf: - $ref: '#/components/schemas/MarketDataResult' '400': description: ValidationFailed | IdempotencyKeyRequired content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationFailedEncoded' - $ref: '#/components/schemas/IdempotencyKeyRequiredEncoded' - $ref: '#/components/schemas/ValidationFailedEncoded' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedEncoded' '402': description: InsufficientBalance content: application/json: schema: $ref: '#/components/schemas/InsufficientBalanceEncoded' '403': description: EndpointNotPermitted | Forbidden content: application/json: schema: anyOf: - $ref: '#/components/schemas/EndpointNotPermittedEncoded' - $ref: '#/components/schemas/ForbiddenEncoded' '409': description: IdempotencyConflict content: application/json: schema: $ref: '#/components/schemas/IdempotencyConflictEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' '503': description: ServiceUnavailable content: application/json: schema: $ref: '#/components/schemas/ServiceUnavailableEncoded' security: - bearer: [] components: schemas: MarketDataResult: type: object properties: id: type: string run_url: type: string description: 在控制台打开 Run，需要工作空间成员权限。 provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED 或 RUNNING 表示仍在执行。COMPLETED 表示已有数据提供商响应，包括非 2xx 响应。FAILED 请读取 failure。STOPPED 表示分派前停止。charge_usd 与状态分别检查。 failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Run 失败原因，仅在 status 为 FAILED 时非 null。 input: type: object output: anyOf: - anyOf: - type: object properties: address: anyOf: - type: string - type: 'null' property_type: anyOf: - type: string - type: 'null' bedrooms: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' bathrooms: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' living_area_sqft: anyOf: - type: integer - type: 'null' lot_size_sqft: anyOf: - type: integer - type: 'null' year_built: anyOf: - type: integer - type: 'null' latitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' longitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' estimated_value_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' value_low_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' value_high_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' comparables_count: anyOf: - type: integer - type: 'null' required: - address - property_type - bedrooms - bathrooms - living_area_sqft - lot_size_sqft - year_built - latitude - longitude - estimated_value_usd - value_low_usd - value_high_usd - comparables_count additionalProperties: false - type: object properties: address: anyOf: - type: string - type: 'null' property_type: anyOf: - type: string - type: 'null' bedrooms: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' bathrooms: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' living_area_sqft: anyOf: - type: integer - type: 'null' lot_size_sqft: anyOf: - type: integer - type: 'null' year_built: anyOf: - type: integer - type: 'null' latitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' longitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' estimated_rent_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' rent_low_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' rent_high_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' comparables_count: anyOf: - type: integer - type: 'null' required: - address - property_type - bedrooms - bathrooms - living_area_sqft - lot_size_sqft - year_built - latitude - longitude - estimated_rent_usd - rent_low_usd - rent_high_usd - comparables_count additionalProperties: false - type: object properties: items: type: array items: type: object properties: property_id: anyOf: - type: string - type: 'null' address: anyOf: - type: string - type: 'null' property_type: anyOf: - type: string - type: 'null' bedrooms: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' bathrooms: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' living_area_sqft: anyOf: - type: integer - type: 'null' lot_size_sqft: anyOf: - type: integer - type: 'null' year_built: anyOf: - type: integer - type: 'null' latitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' longitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' last_sale_price_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' last_sale_date: anyOf: - type: string - type: 'null' owner_names: anyOf: - type: array items: type: string - type: 'null' owner_type: anyOf: - type: string - type: 'null' owner_mailing_address: anyOf: - type: string - type: 'null' owner_occupied: anyOf: - type: boolean - type: 'null' required: - property_id - address - property_type - bedrooms - bathrooms - living_area_sqft - lot_size_sqft - year_built - latitude - longitude - last_sale_price_usd - last_sale_date - owner_names - owner_type - owner_mailing_address - owner_occupied additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: listing_id: anyOf: - type: string - type: 'null' address: anyOf: - type: string - type: 'null' property_type: anyOf: - type: string - type: 'null' bedrooms: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' bathrooms: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' living_area_sqft: anyOf: - type: integer - type: 'null' lot_size_sqft: anyOf: - type: integer - type: 'null' year_built: anyOf: - type: integer - type: 'null' latitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' longitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' status: anyOf: - type: string - type: 'null' listing_type: anyOf: - type: string - type: 'null' listed_date: anyOf: - type: string - type: 'null' days_on_market: anyOf: - type: integer - type: 'null' hoa_fee_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' mls_name: anyOf: - type: string - type: 'null' mls_number: anyOf: - type: string - type: 'null' agent: anyOf: - type: object properties: name: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' website: anyOf: - type: string - type: 'null' required: - name - phone - email - website additionalProperties: false - type: 'null' office: anyOf: - type: object properties: name: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' website: anyOf: - type: string - type: 'null' required: - name - phone - email - website additionalProperties: false - type: 'null' price_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' required: - listing_id - address - property_type - bedrooms - bathrooms - living_area_sqft - lot_size_sqft - year_built - latitude - longitude - status - listing_type - listed_date - days_on_market - hoa_fee_usd - mls_name - mls_number - agent - office - price_usd additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: listing_id: anyOf: - type: string - type: 'null' address: anyOf: - type: string - type: 'null' property_type: anyOf: - type: string - type: 'null' bedrooms: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' bathrooms: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' living_area_sqft: anyOf: - type: integer - type: 'null' lot_size_sqft: anyOf: - type: integer - type: 'null' year_built: anyOf: - type: integer - type: 'null' latitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' longitude: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' status: anyOf: - type: string - type: 'null' listing_type: anyOf: - type: string - type: 'null' listed_date: anyOf: - type: string - type: 'null' days_on_market: anyOf: - type: integer - type: 'null' hoa_fee_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' mls_name: anyOf: - type: string - type: 'null' mls_number: anyOf: - type: string - type: 'null' agent: anyOf: - type: object properties: name: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' website: anyOf: - type: string - type: 'null' required: - name - phone - email - website additionalProperties: false - type: 'null' office: anyOf: - type: object properties: name: anyOf: - type: string - type: 'null' phone: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' website: anyOf: - type: string - type: 'null' required: - name - phone - email - website additionalProperties: false - type: 'null' monthly_rent_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' required: - listing_id - address - property_type - bedrooms - bathrooms - living_area_sqft - lot_size_sqft - year_built - latitude - longitude - status - listing_type - listed_date - days_on_market - hoa_fee_usd - mls_name - mls_number - agent - office - monthly_rent_usd additionalProperties: false required: - items additionalProperties: false - type: object properties: zip: anyOf: - type: string - type: 'null' updated_at: anyOf: - type: string - type: 'null' sale: anyOf: - type: object properties: average_price_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' median_price_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' average_price_per_sqft_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' median_price_per_sqft_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' average_days_on_market: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' median_days_on_market: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' total_listings: anyOf: - type: integer - type: 'null' new_listings: anyOf: - type: integer - type: 'null' required: - average_price_usd - median_price_usd - average_price_per_sqft_usd - median_price_per_sqft_usd - average_days_on_market - median_days_on_market - total_listings - new_listings additionalProperties: false - type: 'null' rental: anyOf: - type: object properties: average_rent_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' median_rent_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' average_rent_per_sqft_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' median_rent_per_sqft_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' average_days_on_market: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' median_days_on_market: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' total_listings: anyOf: - type: integer - type: 'null' new_listings: anyOf: - type: integer - type: 'null' required: - average_rent_usd - median_rent_usd - average_rent_per_sqft_usd - median_rent_per_sqft_usd - average_days_on_market - median_days_on_market - total_listings - new_listings additionalProperties: false - type: 'null' required: - zip - updated_at - sale - rental additionalProperties: false - type: object properties: symbol: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' exchange: anyOf: - type: string - type: 'null' currency: anyOf: - type: string - type: 'null' price: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' change: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' change_percent: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' extended_hours_session: anyOf: - type: string - type: 'null' extended_hours_price: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' extended_hours_change: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' extended_hours_change_percent: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' as_of_text: anyOf: - type: string - type: 'null' required: - symbol - name - exchange - currency - price - change - change_percent - extended_hours_session - extended_hours_price - extended_hours_change - extended_hours_change_percent - as_of_text additionalProperties: false - type: 'null' description: >- 各操作的规范化字段。原生输出保留在 Run 中，可通过 GET /v1/runs/:id 读取。未报告的值为 null；有效空结果保留操作结构，各字段为 null 或 items 为 []，result_status 为 no_result。金额为美元，操作包含 currency 字段时除外。*_date 为 YYYY-MM-DD，*_at 为 ISO 8601 UTC，*_text 为原样返回的展示文本。 - property_value: address, property_type, bedrooms, bathrooms, living_area_sqft ，居住面积, lot_size_sqft, year_built, latitude, longitude, estimated_value_usd, value_low_usd, value_high_usd, comparables_count ，估值所用的可比成交数 - property_rent: address, property_type, bedrooms, bathrooms, living_area_sqft ，居住面积, lot_size_sqft, year_built, latitude, longitude, estimated_rent_usd ，月度, rent_low_usd, rent_high_usd, comparables_count ，估算所用的可比租赁数 - property_search: items[]: property_id, address, property_type, bedrooms, bathrooms, living_area_sqft ，居住面积, lot_size_sqft, year_built, latitude, longitude, last_sale_price_usd, last_sale_date ，YYYY-MM-DD, owner_names[], owner_type, owner_mailing_address, owner_occupied - listings_sale: items[]: listing_id, address, property_type, bedrooms, bathrooms, living_area_sqft ，居住面积, lot_size_sqft, year_built, latitude, longitude, status, listing_type, listed_date ，YYYY-MM-DD, days_on_market, hoa_fee_usd ，月度 HOA 费用, mls_name, mls_number, agent {name, phone, email, website}, office {name, phone, email, website}, price_usd ，挂牌价 - listings_rental: items[]: listing_id, address, property_type, bedrooms, bathrooms, living_area_sqft ，居住面积, lot_size_sqft, year_built, latitude, longitude, status, listing_type, listed_date ，YYYY-MM-DD, days_on_market, hoa_fee_usd ，月度 HOA 费用, mls_name, mls_number, agent {name, phone, email, website}, office {name, phone, email, website}, monthly_rent_usd - market_stats: zip, updated_at ，ISO 8601 UTC，RentCast 最近刷新汇总的时间, sale {average_price_usd, median_price_usd, average_price_per_sqft_usd, median_price_per_sqft_usd, average_days_on_market, median_days_on_market, total_listings, new_listings}, rental {average_rent_usd, median_rent_usd, average_rent_per_sqft_usd, median_rent_per_sqft_usd ，月租金, average_days_on_market, median_days_on_market, total_listings, new_listings} - stock_quote: symbol, name, exchange, currency, price ，常规时段最新价格，单位为 currency；Google Finance 报价可能延迟, change ，相对于上一常规收盘价的绝对变动，单位为 currency, change_percent ，相对于上一常规收盘价的百分点变动，1.5 表示 1.5%, extended_hours_session ，原样展示的时段标签，如 Pre-market 或 After hours，常规时段为 null, extended_hours_price, extended_hours_change、extended_hours_change_percent，盘前盘后报价相对于常规时段价格的变动，单位相同, as_of_text ，Google Finance 页面原样时间戳，不是 ISO 格式，也不是 price 的时间 provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: 数据提供商返回的 HTTP 状态，即使 Run 为 COMPLETED 也应检查。 error: anyOf: - {} - type: 'null' required: - http_status additionalProperties: false - type: 'null' description: |- 仅在 status 为 COMPLETED 时非 null。 - 2xx 响应：output 为任意结构的数据提供商原生 JSON；正文为空时为 null。 - 非 2xx 响应：error 包含数据提供商错误正文，output 为 null。 两种正文均会移除敏感字段。 charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: 精确的美元十进制字符串，小数位数为 2–6，采用唯一规范格式。求和时使用十进制运算或乘以 10^6 转为整数，不使用浮点数。 - type: 'null' description: 此 Solution 响应所含 runs 的总费用，全部 Run 结算前为 null。每个 Run 保留各自费用；失败也可能收费。 charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: 单个 Run 的计费依据；多个 Run 汇总时为 null。各项费用请查看 runs[].charge_basis。 stoppable: type: boolean description: 当前是否可接受停止请求。不保证能在分派前停止 Run。 stop_requested_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' description: 请求停止的时间。如果已开始分派，Run 仍可能继续。 created_at: type: string description: ISO 8601 UTC 时间戳。 format: date-time started_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' completed_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: |- 已保存的追踪字段，可用于筛选 Run，不发送给数据提供商，不影响路由、价格或幂等。 - 最多 20 个键：小写字母、数字和下划线，以字母开头，最长 40 个字符。 - 值：长度为 1–500 的字符串。 - user_id：终端用户的不透明 ID，不得使用邮箱或姓名。 action: type: string enum: - property_value - property_rent - property_search - listings_sale - listings_rental - market_stats - stock_quote result_status: type: string enum: - success - no_result - error - pending description: >- 业务交付状态，与 status 中的最终 Run 生命周期独立。no_result 为有效空结果；error 表示数据提供商输出无法交付。 error: anyOf: - type: object properties: code: type: string message: type: string required: - code - message additionalProperties: false - type: 'null' runs: type: array items: type: object properties: id: type: string run_url: type: string description: 在控制台打开 Run，需要工作空间成员权限。 provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED 或 RUNNING 表示仍在执行。COMPLETED 表示已有数据提供商响应，包括非 2xx 响应。FAILED 请读取 failure。STOPPED 表示分派前停止。charge_usd 与状态分别检查。 failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Run 失败原因，仅在 status 为 FAILED 时非 null。 input: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false output: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: 数据提供商返回的 HTTP 状态，即使 Run 为 COMPLETED 也应检查。 required: - http_status additionalProperties: false - type: 'null' charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- 精确的美元十进制字符串，小数位数为 2–6，采用唯一规范格式。求和时使用十进制运算或乘以 10^6 转为整数，不使用浮点数。 - type: 'null' description: >- 最终费用，精确的美元十进制字符串。QUEUED 或 RUNNING 时为 null。FAILED 状态的 Run 仍可能按接口定价产生非零费用。 charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: 计算费用所用的价格条款。结算前或未尝试调用数据提供商时为 null。 stoppable: type: boolean description: 当前是否可接受停止请求。不保证能在分派前停止 Run。 stop_requested_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' description: 请求停止的时间。如果已开始分派，Run 仍可能继续。 created_at: type: string description: ISO 8601 UTC 时间戳。 format: date-time started_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' completed_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: |- 已保存的追踪字段，可用于筛选 Run，不发送给数据提供商，不影响路由、价格或幂等。 - 最多 20 个键：小写字母、数字和下划线，以字母开头，最长 40 个字符。 - 值：长度为 1–500 的字符串。 - user_id：终端用户的不透明 ID，不得使用邮箱或姓名。 required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata additionalProperties: false result_url: type: string description: >- 通过认证读取规范化结果和总费用的只读 URL 路径，配合 API 服务地址使用。不创建 Run，也不恢复切换。GET /v1/runs/:id 仍返回原生单个 Run。 required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata - action - result_status - error - runs - result_url additionalProperties: false ValidationFailedEncoded: type: object properties: error: type: object properties: code: type: string enum: - validation_failed message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false IdempotencyKeyRequiredEncoded: type: object properties: error: type: object properties: code: type: string enum: - idempotency_key_required message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false UnauthorizedEncoded: type: object properties: error: type: object properties: code: type: string enum: - unauthorized message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false InsufficientBalanceEncoded: type: object properties: error: type: object properties: code: type: string enum: - insufficient_balance message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false EndpointNotPermittedEncoded: type: object properties: error: type: object properties: code: type: string enum: - endpoint_not_permitted message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ForbiddenEncoded: type: object properties: error: type: object properties: code: type: string enum: - forbidden message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false IdempotencyConflictEncoded: type: object properties: error: type: object properties: code: type: string enum: - idempotency_conflict message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false RateLimitedEncoded: type: object properties: error: type: object properties: code: type: string enum: - rate_limited message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ServiceUnavailableEncoded: type: object properties: error: type: object properties: code: type: string enum: - service_unavailable message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false securitySchemes: bearer: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.