{
  "openapi": "3.0.1",
  "info": {
    "title": "Flightpoints Scraper | Award Flights, Miles and Seats",
    "description": "Flightpoints scraper for award flights: export miles, taxes and seats in every cabin, the loyalty program and its alliance, the credit card points that transfer to it, schedules, segments and booking links. A test run gave 100 award itineraries in 21 seconds, 40 fields each, sorted by fewest miles.",
    "version": "1.0",
    "x-build-id": "68Mwpd5N517lN8UM7"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~flightpoints-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-flightpoints-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/silentflow~flightpoints-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-flightpoints-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/silentflow~flightpoints-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-flightpoints-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "origins": {
            "title": "🛫 From",
            "type": "array",
            "description": "Departure airports: 3-letter codes (<code>JFK</code>), city codes (<code>NYC</code> = JFK, EWR and LGA), cities (<code>London</code>) or airport names (<code>Heathrow</code>). Up to 10. Every departure is searched to every arrival in one run.",
            "items": {
              "type": "string"
            }
          },
          "destinations": {
            "title": "🛬 To",
            "type": "array",
            "description": "Arrival airports, written like the departures. <b>Leave empty to explore every destination</b> the loyalty programs fly to from your departure airports: one row per program, route and day with the cheapest award of the day, over about the next 60 days.",
            "items": {
              "type": "string"
            }
          },
          "departureDate": {
            "title": "📅 Departure date",
            "type": "string",
            "description": "First day to search, such as <code>2026-12-15</code>, or a span from today such as <code>30 days</code>. Alone, it searches that one day. <b>Leave both dates empty to search the next 30 days.</b>"
          },
          "endDate": {
            "title": "📅 Last departure date",
            "type": "string",
            "description": "Last day to search, included, for a date window: <code>2026-12-31</code> after <code>2026-12-01</code> searches all of December. Up to 180 days per run. The longer the window, the more itineraries: one route over a month usually returns a few hundred."
          },
          "cabin": {
            "title": "💺 Cabin",
            "enum": [
              "any",
              "economy",
              "premiumEconomy",
              "business",
              "first"
            ],
            "type": "string",
            "description": "Only keep itineraries with award space in this cabin. The best fare of each row (<code>bestMiles</code>, <code>bestTaxes</code>, <code>bestSeats</code>) is then this cabin's. The four cabins are always in the row.",
            "default": "any"
          },
          "programs": {
            "title": "🏷️ Loyalty programs",
            "type": "array",
            "description": "Only keep awards bookable with these programs. Empty searches all 28 programs Flightpoints tracks. In explore mode, one call per chosen program, so fewer programs run faster.",
            "items": {
              "type": "string",
              "enum": [
                "AM",
                "AC",
                "AF/KL",
                "AS",
                "AA",
                "AV",
                "AD",
                "BA",
                "CX",
                "CM",
                "DL",
                "EK",
                "EY",
                "AY",
                "G3",
                "IB",
                "B6",
                "LH",
                "QF",
                "QR",
                "SK",
                "SQ",
                "NK",
                "TP",
                "TK",
                "UA",
                "VS",
                "VA"
              ],
              "enumTitles": [
                "Aeromexico Aeromexico Rewards (AM)",
                "Air Canada Aeroplan (AC)",
                "Air France/KLM Flying Blue (AF/KL)",
                "Alaska Airlines Atmos Rewards (AS)",
                "American Airlines AAdvantage (AA)",
                "Avianca LifeMiles (AV)",
                "Azul Brazilian Airlines TudoAzul (AD)",
                "British Airways Executive Club / Avios (BA)",
                "Cathay Pacific Asia Miles (CX)",
                "Copa Airlines ConnectMiles (CM)",
                "Delta Air Lines SkyMiles (DL)",
                "Emirates Skywards (EK)",
                "Etihad Airways Etihad Guest (EY)",
                "Finnair Finnair Plus / Avios (AY)",
                "GOL Linhas Aéreas Smiles (G3)",
                "Iberia Iberia Club (Avios) (IB)",
                "JetBlue TrueBlue (B6)",
                "Lufthansa Miles & More (LH)",
                "Qantas Frequent Flyer (QF)",
                "Qatar Airways Privilege Club / Avios (QR)",
                "Scandinavian Airlines (SAS) EuroBonus (SK)",
                "Singapore Airlines KrisFlyer (SQ)",
                "Spirit Airlines Free Spirit (NK)",
                "TAP Air Portugal Miles&Go (TP)",
                "Turkish Airlines Miles&Smiles (TK)",
                "United Airlines MileagePlus (UA)",
                "Virgin Atlantic Flying Club (VS)",
                "Virgin Australia Velocity Frequent Flyer (VA)"
              ]
            }
          },
          "transferPartners": {
            "title": "💳 Bookable with points from",
            "type": "array",
            "description": "Only keep awards of the airline programs your credit card points transfer to. <code>chase</code> keeps Flying Blue, Aeroplan, United, British Airways, Virgin Atlantic and the other Chase partners. Each row lists its program's partners in <code>transferPartners</code>.",
            "items": {
              "type": "string",
              "enum": [
                "amex",
                "chase",
                "citi",
                "capitalone",
                "bilt",
                "wellsfargo",
                "rove",
                "amexcanada",
                "amexaustralia"
              ],
              "enumTitles": [
                "American Express Membership Rewards (US)",
                "Chase Ultimate Rewards",
                "Citi ThankYou Points",
                "Capital One Miles",
                "Bilt Rewards",
                "Wells Fargo Rewards",
                "Rove Miles",
                "American Express Membership Rewards (Canada)",
                "American Express Membership Rewards (Australia)"
              ]
            }
          },
          "maxMiles": {
            "title": "🎯 Max miles",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep awards at or under this many miles or points, one way, per passenger. <code>80000</code> for a business class sweet spot. Empty or 0 for no cap."
          },
          "maxTaxes": {
            "title": "💵 Max taxes and fees (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep awards whose cash part (taxes, fees, carrier surcharges) is at or under this amount in US dollars. <code>150</code> leaves out most high-surcharge redemptions. Empty or 0 for no cap."
          },
          "minSeats": {
            "title": "👥 Min seats",
            "minimum": 1,
            "maximum": 9,
            "type": "integer",
            "description": "Only keep awards with at least this many seats in the same cabin, for couples and families. Seat counts are those the airline program shows for the award.",
            "default": 1
          },
          "directOnly": {
            "title": "🛬 Non-stop only",
            "type": "boolean",
            "description": "Only keep non-stop flights.",
            "default": false
          },
          "sortBy": {
            "title": "↕️ Sort by",
            "enum": [
              "miles",
              "taxes",
              "duration",
              "departure",
              "lastSeen"
            ],
            "type": "string",
            "description": "Order of the rows. <b>Fewest miles first</b> puts the cheapest award of the whole search on row 1, using the cabin filter when one is set.",
            "default": "miles"
          },
          "maxItems": {
            "title": "🔢 Max results",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of rows to save. The rows saved are the first ones after the sort, so <code>20</code> with <code>Fewest miles first</code> gives the 20 cheapest awards of the search. A month of one route is usually a few hundred itineraries.",
            "default": 100
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}