{"id":18837685,"url":"https://github.com/h-exx/natex-api","last_synced_at":"2026-05-04T19:42:48.391Z","repository":{"id":60277624,"uuid":"529592995","full_name":"h-exx/natex-api","owner":"h-exx","description":"Ticket finder library for National Express UK","archived":false,"fork":false,"pushed_at":"2022-10-05T08:54:52.000Z","size":67,"stargazers_count":0,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T15:40:47.229Z","etag":null,"topics":["nationalexpress","nodejs","reverse-engineering"],"latest_commit_sha":null,"homepage":"https://npmjs.com/natex-api","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/h-exx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-08-27T13:26:31.000Z","updated_at":"2022-10-04T13:16:39.000Z","dependencies_parsed_at":"2023-01-19T04:30:21.729Z","dependency_job_id":null,"html_url":"https://github.com/h-exx/natex-api","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h-exx%2Fnatex-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h-exx%2Fnatex-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h-exx%2Fnatex-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h-exx%2Fnatex-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/h-exx","download_url":"https://codeload.github.com/h-exx/natex-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239774324,"owners_count":19694700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nationalexpress","nodejs","reverse-engineering"],"created_at":"2024-11-08T02:36:01.696Z","updated_at":"2026-01-28T05:30:14.817Z","avatar_url":"https://github.com/h-exx.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# natex-api\nTicket finder library for National Express UK\n\n#### fyi, this currently does not display connections correctly, only the first journey\n\n\u003cdetails\u003e\u003csummary\u003eChangelog\u003c/summary\u003e\n\n- **0.0.2-5** - 🐛 whoops. forgot a couple things. bugfixes\n- **0.0.1** - :tada: Released with all core features\n\u003c/details\u003e\n\n\n# EXAMPLES\n```js\nimport * as natex from 'natex-api';\nnatex.stationSearch('london'); // Expected input: a place\n/* Expected output:\n[\n{\n  locationName: 'LONDON (Most Popular)',\n  locationCode: '57000',\n  isAirport: false,\n  latitude: null, // these are null as the location is not a specific location. most locations will have a latitude and longitude\n  longitude: null,\n},\n{\n  locationName: 'London Central (LONDON VICTORIA Coach Station',\n  locationCode: '57366',\n  isAirport: false,\n  latitude: '51.492670', // these are null as the location is not a specific location. most locations will have a latitude and longitude\n  longitude: '-0.149220',\n},\n{\n...\n}\n]\n*/\n\nnatex.routeSearch(41000, 57000, { // Expected input: Departure ID, Arrival ID, optional: options (specified below)\n  leaving: {\n    departAfterOrArriveBy: 'DEPART_AFTER' // options: DEPART_AFTER, ARRIVE_BY default: DEPART_AFTER\n    date: \"20/09/2022\", // default: Date.now()\n    time: \"00:00\" // default: Date.now()\n  },\n  passengers: {\n    adults: 1, // default: 1\n    children: 0, // default: 0\n    infants: 0 // default: 0\n  },\n  coachCards: {\n    youthCoachcard: 0, // default: 0\n    seniorCoachard: 0, // default: 0\n    disabledCoachcard: 0 // default: 0\n  }\n});\n/* Expected output:\n[\n{\n  departureID: \"41065\",\n  departureName: \"BRISTOL Bus \u0026 Coach Station\",\n  destinationID: \"57366\",\n  destinationName: \"LONDON VICTORIA Coach Station\",\n  busNumber: \"040\",\n  isAvailable: true\n  departureDateTime: \"2022-09-20T12:00:00\"\n  arrivalDateTime: \"2022-09-20T15:00:00\"\n  fare: {\n    amount: \"8.90\" // Will always be pounds\n    discount: \"0\"\n  },\n  seats: {\n    lowAvailability: false\n    seatStock: 29,\n    maxCapacity: 72,\n    unbookReason: null\n  }\n},\n{\n  departureID: \"41065\",\n  departureName: \"BRISTOL Bus \u0026 Coach Station\",\n  destinationID: \"57286\",\n  destinationName: \"HEATHROW Airport London T2,3 (LHR)\",\n  busNumber: \"201\",\n  isAvailable: false\n  departureDateTime: \"2022-09-20T13:00:00\"\n  arrivalDateTime: \"2022-09-20T15:05:00\"\n  fare: {\n    amount: \"54\" // Will always be pounds\n    discount: \"0\"\n  },\n  seats: {\n    lowAvailability: false\n    seatStock: 0,\n    maxCapacity: 53,\n    unbookReason: \"Seat Availability\"\n  }\n},\n{\n...\n}\n]\n\n*/\n```\n\n# TODO\n### core features\n- [x] Station Search\n- [x] Route search\n### additional core feature\n- [ ] Display multiple connections for Route Search\n### additional features\n- [ ] Bypass ratelimit of route search of 3req/m\n- [ ] Ability to search for return journeys\n  - afaik National Express dont have a discount on returns\n- [ ] Look for all Journey stops\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh-exx%2Fnatex-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fh-exx%2Fnatex-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh-exx%2Fnatex-api/lists"}