Paged Query Existing Images

API Information

• Request Path: /market/page/query
• Request Method: POST
• Content-Type: application/json

Request Headers

Parameter	Type	Required	Description
Authorization	String	Yes	User authentication token
Content-Type	String	Yes	Must be set to application/json

Request Body Structure

Field	Type	Required	Description	Constraints
startDate	String	No	Start date	-
endDate	String	No	End date	-
timeZone	String	No	Time zone used for date conversion and output formatting	e.g. UTC+3 / GMT+3 / Asia/Riyadh
geometry	List<String>	No	Geometry (single or multiple GeoJSON geometry strings)	-
aoiIds	List<Long>	No	AOI IDs, overrides geometry when provided	-
sensorType	Integer	Yes	Sensor type	1=SAR, 2=Optical
pageNumber	int	Yes	Page number	>=1
pageSize	int	Yes	Page size	>0
cloudPercent	Double	No	Cloud cover percentage	-
resolutionLevel	Integer	No	Resolution level: 1-Ultra High, 2-High Resolution - Submeter, 3-High Resolution, 4-Medium-Low Resolution	1/2/3/4

Request Body Example

{
  "startDate": "2023-01-01",
  "endDate": "2026-12-31",
  "geometry": ["{\"type\":\"Polygon\",\"coordinates\":[[[102.61282157031928,21.488503948497097],[106.99114976403081,21.488503948497097],[106.99114976403081,18.594746845159506],[102.61282157031928,18.594746845159506],[102.61282157031928,21.488503948497097]]]}"],
  "sensorType": 1,
  "resolutionLevel": 2,
  "pageNumber": 1,
  "pageSize": 10,
  "cloudPercent": 20.0
}

Response Body Structure

CommonResponse Object

Field	Type	Description
code	Integer	Response status code
message	String	Response message
data	ImageListResp	Response data

ImageListResp Object

Field	Type	Description
total	Long	Total count
content	List<ImageListRespItem>	Product list
timeItems	List<String>	Time items

ImageListRespItem Object

Field	Type	Description
id	Long	Product ID
productId	String	Product ID string
thumb	String	Thumbnail URL
name	String	Product name
resolution	String	Resolution
imageTime	String	Image acquisition time
minSize	BigDecimal	Minimum size
deliveryIn	BigDecimal	Delivery time
unitPrice	BigDecimal	Unit price
geometry	String	Geometry WKT
area	BigDecimal	Area size
amount	BigDecimal	Total amount
discount	BigDecimal	Discount rate
discountAmount	BigDecimal	Discounted amount
discountUnitPrice	BigDecimal	Discounted unit price
satelliteAngle	BigDecimal	Satellite angle
centerLongitude	BigDecimal	Center longitude
centerLatitude	BigDecimal	Center latitude

Response Examples

Success Response

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 100,
    "content": [
      {
        "id": 12345,
        "productId": "product_1",
        "thumb": "http://example.com/thumb.jpg",
        "name": "SAR Image",
        "resolution": "0.5m",
        "imageTime": "2023-06-15 12:00:00",
        "minSize": 25,
        "deliveryIn": 24,
        "unitPrice": 100.00,
        "geometry": "{\"type\":\"Polygon\",\"coordinates\":[[[102.6886899850927,20.21950658516742],[102.451897801616,20.16874196097035],[102.56974195534,19.67552515468356],[102.8057902075779,19.72608503057904],[102.6886899850927,20.21950658516742]]]}",
        "area": 50.5,
        "amount": 5050.00,
        "discount": 0.9,
        "discountAmount": 4545.00,
        "discountUnitPrice": 90.00,
        "satelliteAngle": 15.5,
        "centerLongitude": 120.5,
        "centerLatitude": 30.5
      }
    ],
    "timeItems": ["2023-06-15"]
  }
}

Failure Response

{
  "code": 400,
  "message": "Invalid date format",
  "data": null
}

Error Code Description

Error Code	Description
200	Success
400	Request parameter error
401	Unauthorized
500	Server internal error

Usage Instructions

1. This API is used to query market products with pagination
2. User authentication is required
3. Supports filtering by date range, geometry, AOI, sensor type, and cloud cover.
4. Returns a paginated list of products

Notes

• Geometry should be in WKT format
• Date format should be YYYY-MM-DD