Skip to main content

Response Field Selection

Reduce response payloads by 50-80% with field selection. Request only the fields you need via query parameter or header.

Usage

  • • Query parameter: ?fields=temp,wind.speed,humidity
  • • Header: X-Fields: temp,wind.speed,humidity

Example

# Full response (1.2KB)
GET /api/v1/proxy/open-meteo-forecast?latitude=37.5&longitude=127

# Field-selected response (200B)
GET /api/v1/proxy/open-meteo-forecast?latitude=37.5&longitude=127&fields=current_weather.temperature,current_weather.windspeed

{
  "data": {
    "current_weather.temperature": 22.5,
    "current_weather.windspeed": 8.3
  },
  "meta": {
    "field_selection": ["current_weather.temperature", "current_weather.windspeed"],
    ...
  }
}

Benefits

  • • Reduces network payload and agent context window usage
  • • Dot notation supports nested fields (e.g., data.rates.EUR)
  • • Works with all proxy endpoints (GET, POST, etc.)
  • • Selected fields listed in meta.field_selection
apitree · AI-Native API Marketplace