Skip to content
Happy Endpoint
Motory API
API v1.0 Motory

Motory API

Access Motory used and new car listings in Saudi Arabia and Jordan, with prices, makes, models, dealers, offers and vehicle comparison data.

Overview

The Motory API provides automotive marketplace data for Saudi Arabia and Jordan. Search used and new cars, research vehicle prices and specifications, compare models and inspect dealer records using structured JSON routes.

Search and data coverage

Resolve manufacturers and models with /makes and /models. Used and new car filter endpoints describe the choices available for each search. /used-cars and /new-cars retrieve inventory, with separate detail and URL-based routes for individual vehicles. /compare-new-cars supports model comparison alongside comparison suggestions.

Dealer, offer and finance-provider routes add market context. The automotive directory includes companies, branches, services and cities, while fuel prices, car news and videos support research products that need information beyond inventory. Search suggestions and URL resolution help connect existing links to API workflows.

What you can build

  • Saudi and Jordan car search and price comparison
  • Tracking used vehicle inventory by make and model
  • Comparing new car specifications and dealer offers
  • Automotive dealer and service directory research

Coverage and comparison tips

English and Arabic data are documented for Saudi Arabia and Jordan. Keep the market and vehicle condition consistent when comparing prices. The finance-provider and offer routes provide information for research; they do not submit financing applications.

Getting started

Start with /makes to discover the identifiers and filter values used by the routes above. Then test a focused request such as /makes?condition=used and inspect its JSON response before adding more filters or pagination. The endpoint list below reflects the supplied OpenAPI specification.

Subscribe to the Motory API on RapidAPI to get your API key and view current plans and request limits. Send your key in the X-RapidAPI-Key header and use X-RapidAPI-Host: motory-com.p.rapidapi.com for requests.

Explore 4Sale API and Turo API, or browse the API library for other markets and platforms.

What you can do

Saudi and Jordan car search and price comparison
Tracking used vehicle inventory by make and model
Comparing new car specifications and dealer offers
Automotive dealer and service directory research

Endpoints & Schema

MethodPathSummary
GET/status
GET/makesList car makes with their ids and logos: the used-car makes that have cars for sale, or the full new-car brand catalogue.
GET/modelsList one make's models with their ids, for used cars that are for sale or for the new-car model catalogue.
GET/new-car-lineupShow a make's current new-car line-up: one row per model with starting and top price, body type, model year and images, plus the make's selling companies, optionally narrowed...
GET/used-car-filtersGet the used-car filter options (cities, makes, models, years, price bands, body, fuel, transmission, mileage, colour, origin, electric range, seller types and dealers) with...
GET/new-car-filtersGet the new-car filter options (makes, models, model years, price bands, body, fuel, transmission, origin and electric range) with result counts, narrowed by the /new-cars...
GET/finance-providersList the finance providers that finance new cars, optionally for one make.
GET/fuel-pricesRead the retail fuel prices per litre for Saudi Arabia or Jordan, one entry per fuel grade, with the month of the last update.
GET/used-carsSearch used cars for sale in Saudi Arabia or Jordan by make, model, city, year, price, body, fuel, transmission, mileage, colour, origin, electric range, seller type, dealer,...
GET/used-car-detailsRead one used-car listing in full: specs, VIN, gallery, price, the seller's phone and WhatsApp numbers, inspection reports and related cars.
GET/used-cars-by-urlRun the used-car search that a pasted motory.com search-page link describes (a make, model, city, year or financing page), applying the filters in the link.
GET/used-car-details-by-urlRead a used-car listing in full from its motory.com page link, the same result as /used-car-details without looking up the id first.
GET/new-carsSearch the new-car catalogue with prices by make, model, year, price, body, fuel, transmission, origin, electric range, financing and finance provider.
GET/new-car-detailsRead one new car (a model year and grade) in full: specs, features, other model years and grades, selling companies with phone numbers, and financing.
GET/new-cars-by-urlRun the new-car search that a pasted motory.com search-page link describes (a make, model, year or financing page), applying the filters in the link.
GET/new-car-details-by-urlRead a new car in full from its motory.com page link, the same result as /new-car-details without looking up the id first.
GET/compare-new-carsCompare two new cars side by side: prices and spec-by-spec rows by category, plus similar comparisons.
GET/compare-suggestionsFind new cars to compare: the cars most often compared with a given new car, or the market's most-compared cars this week.
GET/searchSearch all of Motory by keyword across used and new cars, offers, the Saudi business directory, news and videos.
GET/search-suggestionsTurn typed text into make, model and year suggestions that carry ids, for used or new cars.
GET/resolve-urlIdentify any ksa.motory.com or jo.motory.com page link and return its page type with the ids it carries (vehicle, make, model, year, city, dealer, offer, news, video, news or...
GET/dealersList the marketplace's showcased car dealers and showrooms (in Saudi Arabia the featured dealers), optionally for one make, one city or one dealer, with stock counts and a...
GET/dealer-detailsRead one dealer's profile: phones, WhatsApp, showroom map locations, branch count and stock count.
GET/offersList current car offers and financing deals published by distributors and dealers, optionally for one make or one offering company.
GET/offer-detailsRead one car offer: terms, start and end dates, the offering company, the cars on offer with monthly instalment and down payment, and the eligibility terms an application-form...
GET/directory-searchSearch Saudi automotive businesses and companies by name, address, city, make served, service, amenity, opening day, open now, provider kind and agent flag.
GET/directory-business-detailsRead one directory business in full: contacts, address, images, services, amenities, weekly opening hours and the makes it serves.
GET/directory-company-detailsRead one multi-branch directory company in full: contacts, images, services, amenities, opening hours, makes served and branch count.
GET/directory-companiesList or name-search the multi-branch companies of the Saudi automotive directory.
GET/directory-branchesList the branches of one directory company with address, coordinates, phones, weekly opening hours and each branch's services, amenities and makes, optionally by city, service,...
GET/directory-servicesList every service category of the Saudi automotive directory (spare parts, car wash, tyres, inspection, rentals, showrooms) with names in both languages.
GET/directory-amenitiesList every amenity a directory provider can offer (waiting area, parking, Wi-Fi, payment methods) with names in both languages.
GET/directory-citiesList the Saudi cities of the business directory with names and slugs in both languages.
GET/directory-makesList the car makes a directory provider can serve, with names in both languages, logo and link; it also covers trucks, motorcycles and heavy equipment.
GET/news-categoriesList the news categories of a market and language (Car News, Local News, Car Reports, Car Advice).
GET/category-newsList the news articles of one category, newest, oldest or most-read first, optionally narrowed to one author, one make or a title text, as article cards with title, date,...
GET/news-searchSearch news articles by keyword, matched against article titles, newest, oldest or most-read first, optionally narrowed to one category, one author or one make; rows are...
GET/news-detailsRead one news article in full: HTML body, gallery, author, tags and related articles.
GET/author-detailsRead a news author's profile: biography, job title, credentials, social links and topics.
GET/author-newsList one author's news articles, newest, oldest or most-read first, optionally narrowed to one category, one make or a title text, as article cards.
GET/author-tagsList the tags an author writes under (makes, body types, topics), optionally narrowed by a name fragment.
GET/tag-newsList the news articles carrying one tag, a topic such as SUV or a make such as Toyota, newest, oldest or most-read first, optionally narrowed to one category, one author or a...
GET/most-read-newsList the market's most-read news articles as a short list of article cards.
GET/video-categoriesList the video categories of a market (Reviews, Motory Studio, One Minute Brief, Electric Cars).
GET/videosList the marketplace's car videos, newest or oldest first, optionally for one category, make, model or model year; with no filter the featured videos come in a list of their own.
GET/video-detailsRead one video: playable MP4 link, description, category and related videos, news, new cars and offers.

Frequently asked questions

What does the Motory API return?+
Access Motory used and new car listings in Saudi Arabia and Jordan, with prices, makes, models, dealers, offers and vehicle comparison data.
How do I get an API key?+
Subscribe to this API on RapidAPI. You'll get keys, usage dashboards, and plan management out of the box.
Is there a free tier?+
Check the pricing tab on RapidAPI for current plans and testing allowances.
Can I try the data before subscribing?+
Free samples are available for several platforms - see available samples.