{
  "openapi": "3.0.1",
  "info": {
    "title": "Travelstart Scraper - Flights, Hotels and Buses",
    "description": "Extract Travelstart flight fares, hotels, room offers, bus trips and airport suggestions. Choose African flight markets or the global site. Pay per delivered row plus a start fee.",
    "version": "0.1",
    "x-build-id": "rCbeZQrhTuxxwejFN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lentic_clockss~travelstart-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lentic_clockss-travelstart-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/lentic_clockss~travelstart-scraper/runs": {
      "post": {
        "operationId": "runs-sync-lentic_clockss-travelstart-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/lentic_clockss~travelstart-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-lentic_clockss-travelstart-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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "auto",
              "flightsSearch",
              "suggestions",
              "airportSuggest",
              "hotelsSearch",
              "hotelDetails",
              "hotelsRecommended",
              "buses",
              "busLocations",
              "carsSearch",
              "packages"
            ],
            "type": "string",
            "description": "Choose a mode or leave auto to infer it from target fields. Hotel IDs select hotelDetails, a place ID selects hotelsSearch, a query selects suggestions, and from plus to selects flightsSearch.",
            "default": "auto"
          },
          "query": {
            "title": "Query",
            "type": "string",
            "description": "Enter airport or city text for suggestions, a hotel city for hotelsSearch, or a stop name for busLocations. Choose hotelsSearch explicitly for a hotel city query."
          },
          "from": {
            "title": "Origin",
            "type": "string",
            "description": "Flights: origin IATA code or city. Buses: departure city (e.g. Johannesburg)."
          },
          "to": {
            "title": "Destination",
            "type": "string",
            "description": "Flights: destination IATA code or city. Buses: arrival city (e.g. Cape Town)."
          },
          "hotelIds": {
            "title": "Hotel ids",
            "type": "array",
            "description": "For hotelDetails, enter hotel IDs returned by hotelsSearch. Multiple IDs can be supplied in one run.",
            "items": {
              "type": "string"
            }
          },
          "placeId": {
            "title": "Hotel place id",
            "type": "string",
            "description": "For hotelsSearch, enter a known hotel place identifier instead of a city query."
          },
          "countrySite": {
            "title": "Country site",
            "enum": [
              "travelstart.com",
              "travelstart.co.za",
              "travelstart.com.ng",
              "travelstart.co.ke",
              "AE",
              "BH",
              "BW",
              "DZ",
              "EG",
              "GH",
              "JO",
              "KW",
              "LY",
              "MA",
              "ME",
              "MW",
              "NA",
              "OM",
              "PK",
              "QA",
              "SA",
              "TN",
              "TT",
              "TZ"
            ],
            "type": "string",
            "description": "Select a flight market using a Travelstart domain or a listed market code. Flight prices use that market currency; hotel and bus coverage is mode-specific.",
            "default": "travelstart.com"
          },
          "departureDate": {
            "title": "Departure date",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "Departure date in YYYY-MM-DD format. When omitted, defaults to 24 days from today."
          },
          "returnDate": {
            "title": "Return date",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "Return date in YYYY-MM-DD format. Return flights default to seven days after departure; enter a date explicitly for return bus trips."
          },
          "tripType": {
            "title": "Trip type",
            "enum": [
              "return",
              "oneway",
              "multi"
            ],
            "type": "string",
            "description": "Choose return, oneway or multi. Multi-city flights require at least two entries in legs, each with from, to and departureDate.",
            "default": "return"
          },
          "cabin": {
            "title": "Cabin",
            "enum": [
              "ECONOMY",
              "PREMIUM",
              "BUSINESS",
              "FIRST"
            ],
            "type": "string",
            "description": "Choose ECONOMY, PREMIUM, BUSINESS or FIRST for flight searches.",
            "default": "ECONOMY"
          },
          "adults": {
            "title": "Adults",
            "minimum": 1,
            "type": "integer",
            "description": "Number of adult flight travellers or bus passengers, from 1 to 9. For hotels, this is the adult count per room.",
            "default": 1
          },
          "children": {
            "title": "Children",
            "minimum": 0,
            "type": "integer",
            "description": "Number of child flight travellers, from 0 to 8. Use childrenAges for hotels.",
            "default": 0
          },
          "infants": {
            "title": "Infants",
            "minimum": 0,
            "type": "integer",
            "description": "Number of infant flight travellers, from 0 to 4.",
            "default": 0
          },
          "youngAdults": {
            "title": "Young adults",
            "minimum": 0,
            "type": "integer",
            "description": "Number of young-adult flight travellers, from 0 to 8.",
            "default": 0
          },
          "currency": {
            "title": "Hotel currency",
            "type": "string",
            "description": "Hotels: price currency (default ZAR). Flight prices come in the market's currency."
          },
          "legs": {
            "title": "Multi-city legs",
            "type": "array",
            "description": "For multi-city flights, enter at least two objects containing from, to and departureDate. Use IATA codes or city names and YYYY-MM-DD dates."
          },
          "checkin": {
            "title": "Hotel check-in",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "YYYY-MM-DD (default: 24 days from today)."
          },
          "checkout": {
            "title": "Hotel check-out",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "Hotel check-out date in YYYY-MM-DD format. If omitted or not after check-in, it is set to one day after check-in."
          },
          "rooms": {
            "title": "Hotel rooms",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "Hotel room count from 1 to 8; defaults to 1. The adults and childrenAges values apply to each room."
          },
          "childrenAges": {
            "title": "Hotel children ages",
            "type": "array",
            "description": "Hotel children's ages per room, such as [5, 9], with at most eight ages. Omit for no children."
          },
          "guestNationality": {
            "title": "Guest nationality",
            "type": "string",
            "description": "Hotels: ISO country of the guests (default ZA)."
          },
          "scrapeDetails": {
            "title": "Hotel details in search",
            "type": "boolean",
            "description": "hotelsSearch: also read each hotel's details (its own phone, postal code, policies). Slower.",
            "default": false
          },
          "includeRooms": {
            "title": "Emit room offers",
            "type": "boolean",
            "description": "For hotelDetails, emit separate room-offer rows when available; each is billed at the same price as a hotel row. Off by default; all rows share the per-hotel limit.",
            "default": false
          },
          "maxResults": {
            "title": "Max results per search or hotel ID",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum rows for each search route/query or each hotel ID (default 70, up to 1000). Larger values are collected in parts of up to 70 rows. All row types, including opt-in room offers, share the budget for their input. The run stops at your maximum total charge; free Apify plans allow 200 rows per run and 10 runs.",
            "default": 70
          },
          "workerBaseUrl": {
            "title": "Developer test setting",
            "type": "string",
            "description": "Leave empty. Used only by the developer for testing."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}