比价搜索

Atlas API 比价搜索端点参考，用于检索和比较可用航班报价，支持后续报价或预订决策。

💬 需要帮助？ 如果遇到问题，请在帮助中心咨询 Eva，快速获取诊断建议。

咨询 Eva

使用此 API 进行售前航线覆盖和原始价格发现。

这不是标准的预订步骤。

priceCompareSearch.do 仅对售前客户可用。

默认使用配额为每天 1,000 次调用。

不要将返回的价格视为生产预订价格。

此 API 的功能

• 以最大航线覆盖范围返回原始价格

• 跳过预订规则过滤

• 忽略供应商运营开关

• 先检查 Atlas 缓存，然后回退到航司实时定价

请求兼容性

请求体与 search.do 完全兼容。

无需额外请求字段。

使用相同的核心字段：

• tripType、adultNum、childNum、infantNum

• fromCity、toCity、fromDate、retDate

• airlines、currency、includeMultipleFareFamily

如何读取响应

当存在结果时

API 返回 status: 0、msg: "success" 和非空的 routings 数组。

routings 结构匹配 search.do。

当不存在结果时

没有结果仍然返回 status: 0。

这是正常的业务结果。

检查以下两者：

• routings.length

• noResultReason.code

不要仅依赖 status。

noResultReason

当 routings 为空时，响应可能包含 noResultReason。

它包含：

• code — 机器可读的原因

• message — 人类可读的详情

• recentFlightDates — 可选的实际航班计划附近日期

原因代码

ROUTE_NOT_SUPPORTED

该航线不在 Atlas 覆盖范围内。

不要重试同一航线。

AIRLINE_NO_FLIGHT

航司未返回该航线和日期的航班信息。

检查 recentFlightDates 并使用其他支持的日期重试。

FLIGHT_SOLD_OUT

航班存在，但无可用座位。

检查 recentFlightDates 并使用其他日期重试。

PRICE_FETCH_FAILED

Atlas 无法从航司获取价格。

将此视为临时技术故障。

稍后重试。

recentFlightDates 如何工作

recentFlightDates 返回搜索日期前后最多 7 个实际计划日期。

窗口目标为前后 3 天。

如果较早日期不可用，较晚日期将填补空缺。

列表仅包含有实际航班计划的日期。

API 级别错误

status != 0 表示请求在 API 级别失败。

常见值包括：

• 100、101、102 — 请求数据缺失或无效

• 109 — 超出搜索限制

• 110 — 超出 QPS 限制

• 112 — 请求超时

• 900 — 未授权

• 9999 — 内部错误

集成指导

当你想在生产集成前评估 Atlas 航线覆盖范围时使用此 API。

当需要可预订的路径时，使用标准预订流程。

有关从搜索到出票的正常流程，请参见预订概述。

Price Compare Search

post

Purpose: Search comparable fares for a route/date/airline filter. The endpoint performs synchronous smart search and is intended for fare comparison scenarios.

Dependency: No preceding function needs to be called before this API.

Important notes:

• The returned settlement currency is determined by client configuration or the optional currency request field.

• Total payable amount for one adult passenger is normally adultPrice + adultTax + transactionFeePerPax.

• When supportCreditTransPayment = 1, vendorFare contains the airline/vendor-side fare. When pass-through payment is not supported, supportCreditTransPayment = 0 and vendorFare may be null or omitted.

• ancillaryProductElements depends on client configuration and airline support.

• links may include airline terms and conditions.

• When status = 0 but routings is empty, check noResultReason for the business reason and possible recent available flight dates.

• Display-currency values are for display only and should not be used for settlement, fare comparison, or accounting.

Header parameters

AcceptstringRequired

Expected response media type. Use application/json.

Example: application/json

Content-TypestringRequired

Request body media type. Use application/json.

Example: application/json

Accept-EncodingstringRequired

Enable gzip response compression when supported.

Example: gzip

x-atlas-client-idstringRequired

Atlas client ID. The server uses this value as the request customer identifier.

Example: JWC21872_api_1

x-atlas-client-secretstringRequired

Atlas client secret for authentication. Use the secret assigned to the client ID.

Example: w(s5VY8[qAT!vwcXa}DC%4O2$f5mY7sL

Body

application/json

tripTypestring · enumRequired

Trip type. 1 = one-way, 2 = round trip. retDate is required when tripType = 2.

Example: 2Possible values:

requestIdstring · nullableOptional

Client-side request identifier for tracing and troubleshooting. Optional but recommended.

Example: pc-20260222-0001

adultNuminteger · min: 1 · max: 9Required

Adult passenger count. Must be at least 1. adultNum + childNum cannot exceed 9.

Default: 0Example: 1

childNuminteger · max: 8Required

Child passenger count. adultNum + childNum cannot exceed 9.

Default: 0Example: 0

infantNuminteger · max: 9Required

Infant passenger count. Cannot exceed the adult passenger count.

Default: 0Example: 0

fromCitystringRequired

Departure city or airport IATA code in uppercase. If an airport code is supplied here, results are filtered by that airport.

Example: KUL

fromAirportstring · nullableOptional

Optional departure airport IATA code. Leave empty when fromCity already represents the desired city/airport filter.

toCitystringRequired

Arrival city or airport IATA code in uppercase. If an airport code is supplied here, results are filtered by that airport.

Example: BKI

toAirportstring · nullableOptional

Optional arrival airport IATA code. Leave empty when toCity already represents the desired city/airport filter.

fromDatestringRequired

Departure date in YYYYMMDD format.

Example: 20260222Pattern: ^\d{8}$

retDatestring · nullableOptional

Return date in YYYYMMDD format. Required for round-trip searches; use null or omit for one-way searches.

Example: 20260222Pattern: ^\d{8}$

airlinesstring[] · nullableOptional

Airline IATA code filter in uppercase. The response only contains flights operated/marketed by the specified airlines when supplied.

Example: ["OD"]

fromFlightNumbersstring[] · nullableOptional

Optional outbound flight-number filter. Use one string per candidate itinerary. For connecting flights, join segment flight numbers with a comma, e.g. OD1001,OD1002.

Example: ["OD1001"]

retFlightNumbersstring[] · nullableOptional

Optional return flight-number filter. For connecting flights, join segment flight numbers with a comma.

Example: ["OD1002"]

includeMultipleFareFamilyboolean · nullableOptional

Whether to return multiple fare families for the same flight. false returns the lowest fare per flight by default.

Default: falseExample: false

currencystring · nullableOptional

Optional settlement currency in ISO 4217 format. Use only when the client has multiple settlement currencies configured with Atlas.

Example: USD

displayCurrencystring · nullableOptional

Optional display currency in ISO 4217 format. Display-currency amounts are for presentation only and should not be used for settlement or accounting.

Example: USD

maxResponseTimeinteger · nullableOptional

Optional client-side expected maximum response time in milliseconds. Actual timeout is also controlled by Atlas configuration.

Example: 30000

baggagePieceinteger · nullableOptional

Optional requested checked baggage pieces used for filtering or pricing when supported.

Example: 1

baggageWeightinteger · nullableOptional

Optional requested checked baggage weight in kilograms used for filtering or pricing when supported.

Example: 20

requestSourcestring · nullableOptional

Traffic source label, e.g. Google Flights, Organic Search, or SkyScanner. Used for analytics and traffic governance.

Example: SkyScanner

channelstring · nullableOptional

Optional client channel label used for reporting and traffic segmentation.

Example: API

mainChannelstring · nullableOptional

Optional primary channel label used for reporting and traffic segmentation.

Example: META

subChannelIDstring · nullableOptional

Optional secondary channel identifier used for reporting and traffic segmentation.

Example: skyscanner-us

residentCodestring · nullableOptional

Optional resident discount code when an airline or market supports resident fares.

Example: MY

Responses

200

Successful HTTP response. Business success or failure is indicated by the status field in the response body.

application/json

statusintegerRequired

Business status code. 0 means success. Common non-zero values:

• 100: Missing required request data.
• 101: Illegal request data or invalid format.
• 102: Illegal request parameter.
• 105: OD is not in the client's round-trip whitelist.
• 106: Search is not allowed for this client.
• 107: Insufficient balance.
• 108: Route is restricted or blocked by system limitations.
• 109: Search limit exceeded. For price compare, this may also mean daily quota exceeded.
• 110: Too many concurrent requests.
• 111: Real-time search is not allowed.
• 112: Search timed out.
• 113: Airline is under maintenance in Atlas.
• 114: No flights present.
• 116: Search data was not captured.
• 123: Too many requests but too few paid orders.
• 124: Unsupported settlement currency.
• 126: requestId does not exist or request is already ended.
• 900: Unauthorized access.
• 9999: Internal system error.

msgstring · nullableRequired

Business message. Usually success or null for successful responses; contains the error message when status is non-zero.

requestIdstring · nullableOptional

Atlas request identifier returned for tracing. May be absent when the request fails before request initialization.

Example: ATLAS-20260222-000001

clientRequestIdstring · nullableOptional

Echo of the client request identifier when provided.

Example: pc-20260222-0001

smartEndboolean · nullableOptional

Whether the smart-search process has completed for this synchronous response.

Example: true

post/priceCompareSearch.do

HTTPcURLJavaScriptPython

POST /priceCompareSearch.do HTTP/1.1
Accept: text
Accept-Encoding: text
x-atlas-client-id: text
x-atlas-client-secret: text
Content-Type: application/json
Content-Length: 465

{
  "requestId": "pc-20260222-0001",
  "tripType": "2",
  "adultNum": 1,
  "childNum": 0,
  "infantNum": 0,
  "fromCity": "KUL",
  "fromAirport": "",
  "toCity": "BKI",
  "toAirport": "",
  "fromDate": "20260222",
  "retDate": "20260222",
  "airlines": [
    "OD"
  ],
  "fromFlightNumbers": [
    "OD1001"
  ],
  "retFlightNumbers": [
    "OD1002"
  ],
  "includeMultipleFareFamily": false,
  "currency": "USD",
  "displayCurrency": "USD",
  "requestSource": "SkyScanner",
  "channel": "API",
  "mainChannel": "META",
  "subChannelID": "skyscanner-us",
  "residentCode": null
}

200

Successful HTTP response. Business success or failure is indicated by the status field in the response body.

{
  "status": 0,
  "msg": null,
  "routings": [
    {
      "routingIdentifier": "TE9OX1BBUl8yXzIwMjUwODE4XzIwMjUwODIwXzFfMF8wfHR2aWluNjU0Mjh8MnwyMzIuMzhfMjMyLjM4XzYwLjE5XzQuMDBfNTI4Ljk1X1VTRHxMT05fUEFSXzFfMjAyNTA4MThfXzFfMF8wXkxHVy1VMjg0MDUtLUNERy0yMDI1MDgxODE2NDAtMjAyNTA4MTgxODU1LVN0YW5kYXJkLTEtXjE3MC4xNV8xNzAuMTVfMzUuMTZfMi4wMF8zNzcuNDZeQUVDQUVVUl9BRUNeXkFFQzFMT05QQVIyMDAyMDI1MDgxOF5HQlBeMTI1LjMwXjEyNS4zMF4yNS44OV4xJFBBUl9MT05fMl8yMDI1MDgyMF9fMV8wXzBeQ0RHLVUyODQxMC0tTEdXLTIwMjUwODIwMTkxMC0yMDI1MDgyMDE5MjAtU3RhbmRhcmQtMS1eNjIuMjNfNjIuMjNfMjUuMDNfMi4wMF8xNTEuNDleQUVDQUVVUl9BRUNeXkFFQzFQQVJMT04yMDAyMDI1MDgyMF5FVVJeNTMuMTJeNTMuMTJeMjEuMzZeMXwwfDIwMjUwODE2MTUyNzU2fDB8MTc1NTMyOTI3MTAyNFJ2VzdJfHx8fDF8Mi4wMHwzfDB8fG5vcm1hbHxmYWxzZQ==.zkLMRkU3ohHS9/5p28KK1Jw4PTWTsICx24yIQoygMMw=",
      "supportCreditTransPayment": "0",
      "supportPaymentMethods": [
        1,
        5
      ],
      "currency": "USD",
      "adultPrice": 232.38,
      "adultTax": 0,
      "adultDetails": [
        {
          "code": "tax",
          "type": "tax",
          "amount": 0,
          "description": ""
        },
        {
          "code": "farePrice",
          "type": "base",
          "amount": 232.38,
          "description": ""
        }
      ],
      "childPrice": 232.38,
      "childTax": 0,
      "childDetails": [
        {
          "code": "tax",
          "type": "tax",
          "amount": 0,
          "description": ""
        },
        {
          "code": "farePrice",
          "type": "base",
          "amount": 232.38,
          "description": ""
        }
      ],
      "infantPrice": 60.19,
      "infantTax": 0,
      "infantDetails": [
        {
          "code": "tax",
          "type": "tax",
          "amount": 0,
          "description": ""
        },
        {
          "code": "farePrice",
          "type": "base",
          "amount": 60.19,
          "description": ""
        }
      ],
      "infantAllowed": true,
      "childMandatorySeatingFee": null,
      "transactionFeePerPax": 2,
      "transactionFee": 2,
      "transactionFeeMode": "PER_PAX",
      "fromSegments": [
        {
          "aircraftCode": "",
          "arrAirport": "CDG",
          "arrTerminal": "",
          "arrTime": "202508181855",
          "cabin": "",
          "cabinClass": 1,
          "carrier": "U2",
          "codeShare": false,
          "depAirport": "LGW",
          "depTerminal": "",
          "depTime": "202508181640",
          "duration": 75,
          "fareFamily": "Standard",
          "flightNumber": "U28405",
          "operatingCarrier": "",
          "operatingFlightnumber": "",
          "seatCount": 3,
          "segmentIndex": 1,
          "stopCities": ""
        }
      ],
      "retSegments": [
        {
          "aircraftCode": "",
          "arrAirport": "LGW",
          "arrTerminal": "",
          "arrTime": "202508201920",
          "cabin": "",
          "cabinClass": 1,
          "carrier": "U2",
          "codeShare": false,
          "depAirport": "CDG",
          "depTerminal": "",
          "depTime": "202508201910",
          "duration": 70,
          "fareFamily": "Standard",
          "flightNumber": "U28410",
          "operatingCarrier": "",
          "operatingFlightnumber": "",
          "seatCount": 6,
          "segmentIndex": 2,
          "stopCities": ""
        }
      ],
      "rule": {
        "hasBaggage": 1,
        "baggageElements": [
          {
            "segmentNo": 1,
            "baggageType": "CabinBaggageUnderSeat",
            "passengerType": 0,
            "baggagePiece": 1,
            "baggageWeight": 15,
            "baggageSize": "45*36*20cm"
          },
          {
            "segmentNo": 1,
            "baggageType": "StandardCheckInBaggage",
            "passengerType": 0,
            "baggagePiece": 0,
            "baggageWeight": 0,
            "baggageSize": ""
          },
          {
            "segmentNo": 2,
            "baggageType": "CabinBaggageUnderSeat",
            "passengerType": 0,
            "baggagePiece": 1,
            "baggageWeight": 15,
            "baggageSize": "45*36*20cm"
          },
          {
            "segmentNo": 2,
            "baggageType": "StandardCheckInBaggage",
            "passengerType": 0,
            "baggagePiece": 0,
            "baggageWeight": 0,
            "baggageSize": ""
          }
        ],
        "refundRules": [
          {
            "refundType": 0,
            "refundStatus": "T",
            "refundMethod": "CashBackToOriginalPayment",
            "refundFee": 0,
            "currency": "GBP",
            "refNoshow": "T",
            "refNoShowCondition": 0,
            "refNoshowFee": 0,
            "ruleDetailList": [
              {
                "status": "T",
                "refundMethod": "CashBackToOriginalPayment",
                "startMinute": 525600,
                "endMinute": 0,
                "amount": 0,
                "currency": "GBP"
              },
              {
                "status": "T",
                "refundMethod": "CashBackToOriginalPayment",
                "startMinute": 0,
                "endMinute": -525600,
                "amount": 0,
                "currency": "GBP"
              }
            ]
          },
          {
            "refundType": 0,
            "refundStatus": "T",
            "refundMethod": "CashBackToOriginalPayment",
            "refundFee": 0,
            "currency": "GBP",
            "refNoshow": "T",
            "refNoShowCondition": 0,
            "refNoshowFee": 0,
            "ruleDetailList": [
              {
                "ruleId": 47379,
                "status": "T",
                "refundMethod": "CashBackToOriginalPayment",
                "startMinute": 525600,
                "endMinute": 0,
                "amount": 0,
                "currency": "GBP"
              },
              {
                "ruleId": 47381,
                "status": "T",
                "refundMethod": "CashBackToOriginalPayment",
                "startMinute": 0,
                "endMinute": -525600,
                "amount": 0,
                "currency": "GBP"
              }
            ]
          }
        ],
        "changesRules": [
          {
            "changesType": 0,
            "changesStatus": "T",
            "changesFee": 0,
            "currency": "GBP",
            "revNoshow": "T",
            "revNoShowCondition": 0,
            "revNoshowFee": 0,
            "ruleDetailList": [
              {
                "status": "H",
                "refundMethod": null,
                "startMinute": 525600,
                "endMinute": 86400,
                "amount": 30,
                "currency": "GBP"
              },
              {
                "ruleId": 47387,
                "status": "H",
                "refundMethod": null,
                "startMinute": 86400,
                "endMinute": 120,
                "amount": 49,
                "currency": "GBP"
              },
              {
                "ruleId": 47389,
                "status": "T",
                "refundMethod": null,
                "startMinute": 120,
                "endMinute": 0,
                "amount": 0,
                "currency": "GBP"
              },
              {
                "ruleId": 47391,
                "status": "T",
                "refundMethod": null,
                "startMinute": 0,
                "endMinute": -525600,
                "amount": 0,
                "currency": "GBP"
              }
            ]
          },
          {
            "changesType": 0,
            "changesStatus": "T",
            "changesFee": 0,
            "currency": "GBP",
            "revNoshow": "T",
            "revNoShowCondition": 0,
            "revNoshowFee": 0,
            "ruleDetailList": [
              {
                "ruleId": 47385,
                "status": "H",
                "refundMethod": null,
                "startMinute": 525600,
                "endMinute": 86400,
                "amount": 30,
                "currency": "GBP"
              },
              {
                "ruleId": 47387,
                "status": "H",
                "refundMethod": null,
                "startMinute": 86400,
                "endMinute": 120,
                "amount": 45.91,
                "currency": "GBP"
              },
              {
                "ruleId": 47389,
                "status": "T",
                "refundMethod": null,
                "startMinute": 120,
                "endMinute": 0,
                "amount": 0,
                "currency": "GBP"
              },
              {
                "ruleId": 47391,
                "status": "T",
                "refundMethod": null,
                "startMinute": 0,
                "endMinute": -525600,
                "amount": 0,
                "currency": "GBP"
              }
            ]
          }
        ],
        "serviceElements": [
          {
            "hasFreeSeat": 0,
            "hasFreeMeal": 0
          },
          {
            "hasFreeSeat": 0,
            "hasFreeMeal": 0
          }
        ]
      },
      "ancillaryProductElements": [
        {
          "ancillaryCode": "CBOL_1PC_15KG_MAXIMUM SIZE 56 X 45 X 25 CM",
          "auxBaggageElement": {
            "piece": 1,
            "weight": 15,
            "isAllWeight": true,
            "size": "Maximum Size 56 x 45 x 25 cm"
          },
          "canPurchaseWithTicket": 1,
          "canPurchasePostTicket": 0,
          "categoryCode": "CabinBaggageOverheadLocker",
          "clientTechnicalServiceFee": 0,
          "currency": "USD",
          "maxQty": 1,
          "minQty": 1,
          "price": 26.57,
          "productCode": "CBOL_1PC_15KG_MAXIMUM SIZE 56 X 45 X 25 CM",
          "segmentIndex": 1,
          "vendorPrice": 19.56,
          "vendorCurrency": "GBP"
        },
        {
          "segmentIndex": 1,
          "productCode": "SCI_BAG_1PC_15KG",
          "canPurchaseWithTicket": 1,
          "canPurchasePostTicket": 0,
          "price": 27.12,
          "currency": "USD",
          "vendorPrice": 19.97,
          "vendorCurrency": "GBP",
          "clientTechnicalServiceFee": 0,
          "clientTechnicalServiceFeeMode": null,
          "auxBaggageElement": {
            "piece": 1,
            "weight": 15,
            "isAllWeight": true,
            "size": ""
          },
          "maxQty": 1,
          "minQty": 1,
          "categoryCode": "StandardCheckInBaggage",
          "ancillaryCode": "SCI_BAG_1PC_15KG"
        },
        {
          "segmentIndex": 1,
          "productCode": "SCI_BAG_2PC_30KG",
          "canPurchaseWithTicket": 1,
          "canPurchasePostTicket": 0,
          "price": 39.95,
          "currency": "USD",
          "vendorPrice": 29.42,
          "vendorCurrency": "GBP",
          "clientTechnicalServiceFee": 0,
          "clientTechnicalServiceFeeMode": null,
          "auxBaggageElement": {
            "piece": 2,
            "weight": 30,
            "isAllWeight": true,
            "size": ""
          },
          "maxQty": 1,
          "minQty": 1,
          "categoryCode": "StandardCheckInBaggage",
          "ancillaryCode": "SCI_BAG_2PC_30KG"
        },
        {
          "segmentIndex": 2,
          "productCode": "CBOL_1PC_15KG_MAXIMUM SIZE 56 X 45 X 25 CM",
          "canPurchaseWithTicket": 1,
          "canPurchasePostTicket": 0,
          "price": 41.67,
          "currency": "USD",
          "vendorPrice": 35.56,
          "vendorCurrency": "EUR",
          "clientTechnicalServiceFee": 0,
          "clientTechnicalServiceFeeMode": null,
          "auxBaggageElement": {
            "piece": 1,
            "weight": 15,
            "isAllWeight": true,
            "size": "Maximum Size 56 x 45 x 25 cm"
          },
          "maxQty": 1,
          "minQty": 1,
          "categoryCode": "CabinBaggageOverheadLocker",
          "ancillaryCode": "CBOL_1PC_15KG_MAXIMUM SIZE 56 X 45 X 25 CM"
        },
        {
          "segmentIndex": 2,
          "productCode": "SCI_BAG_1PC_15KG",
          "canPurchaseWithTicket": 1,
          "canPurchasePostTicket": 0,
          "price": 31.09,
          "currency": "USD",
          "vendorPrice": 26.53,
          "vendorCurrency": "EUR",
          "clientTechnicalServiceFee": 0,
          "clientTechnicalServiceFeeMode": null,
          "auxBaggageElement": {
            "piece": 1,
            "weight": 15,
            "isAllWeight": true,
            "size": ""
          },
          "maxQty": 1,
          "minQty": 1,
          "categoryCode": "StandardCheckInBaggage",
          "ancillaryCode": "SCI_BAG_1PC_15KG"
        },
        {
          "segmentIndex": 2,
          "productCode": "SCI_BAG_2PC_30KG",
          "canPurchaseWithTicket": 1,
          "canPurchasePostTicket": 0,
          "price": 74.57,
          "currency": "USD",
          "vendorPrice": 63.64,
          "vendorCurrency": "EUR",
          "clientTechnicalServiceFee": 0,
          "clientTechnicalServiceFeeMode": null,
          "auxBaggageElement": {
            "piece": 2,
            "weight": 30,
            "isAllWeight": true,
            "size": ""
          },
          "maxQty": 1,
          "minQty": 1,
          "categoryCode": "StandardCheckInBaggage",
          "ancillaryCode": "SCI_BAG_2PC_30KG"
        }
      ],
      "links": [
        {
          "carrier": "U2",
          "kind": "terms",
          "link": "https://www.easyjet.com",
          "description": null
        }
      ],
      "separateBookings": true,
      "refreshTime": "2025-08-15T22:48:58Z",
      "expireTime": "2025-08-16T07:27:56Z",
      "ancillarySupported": null,
      "cardChargeList": [
        {
          "cardType": "Visa",
          "percentage": 0.03,
          "charge": null,
          "currency": ""
        },
        {
          "cardType": "MasterCard",
          "percentage": 0.03,
          "charge": null,
          "currency": ""
        }
      ],
      "vendorFare": {
        "vendorAdultPrice": 232.38,
        "vendorAdultTax": 0,
        "vendorChildPrice": 232.38,
        "vendorChildTax": 0,
        "vendorInfantPrice": 60.19,
        "vendorInfantTax": 0,
        "vendorCurrency": "USD"
      }
    }
  ],
  "requestId": "ATLAS-20260222-000001",
  "clientRequestId": "pc-20260222-0001",
  "smartEnd": true,
  "noResultReason": null
}