Ford APIford.com ↗
Retrieve 60+ official Ford Ranger images and 6 videos via a single endpoint. Returns image URLs, DASH/HLS stream URLs, poster thumbnails, and vehicle metadata.
What is the Ford API?
The Ford.com Ranger Gallery API exposes one endpoint — get_gallery — that returns a structured collection of 60+ images and 6 videos pulled directly from Ford's official Ranger gallery page. Each response includes image URLs with descriptive titles, video streaming URLs in both DASH and HLS formats, poster thumbnails, and summary counts for both media types, making it straightforward to build or populate any vehicle media display.
curl -X GET 'https://api.parse.bot/scraper/d8a360df-cd3e-433f-be8c-deb2b2cb5164/get_gallery?media_type=all' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ford-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Ford Ranger Gallery — fetch images and videos from the official gallery."""
from parse_apis.ford_com_api import Ford, MediaType, InvalidMediaType
client = Ford()
# Fetch the full gallery (images + videos)
try:
gallery = client.galleries.get()
except InvalidMediaType as e:
print(f"Invalid media type: {e.message}")
raise
print(f"{gallery.vehicle} — {gallery.total_images} images, {gallery.total_videos} videos")
# Browse the first 5 images
for img in gallery.images[:5]:
print(f" [image] {img.title[:60]}")
print(f" {img.url}")
# Browse videos and their streaming URLs
for vid in gallery.videos[:3]:
print(f" [video] {vid.title} (id={vid.video_id})")
if vid.poster_url is not None:
print(f" poster: {vid.poster_url}")
print(f" desktop stream: {vid.streams.desktop}")
# Fetch only videos using the media_type filter
videos_only = client.galleries.get(media_type=MediaType.VIDEOS)
print(f"Videos-only request returned {videos_only.total_videos} videos")
print("exercised: galleries.get / MediaType enum / Image fields / Video + VideoStreams fields")
Retrieves all pictures and videos of the Ford Ranger from the official Ford gallery page. Returns image URLs with descriptive titles and video streaming URLs (DASH/HLS) with poster thumbnails. One HTTP round-trip to fetch the page. Typically returns 60+ images and 6 videos. The media_type filter controls whether images, videos, or both are included in the response.
| Param | Type | Description |
|---|---|---|
| media_type | string | Filter results by media type. |
{
"type": "object",
"fields": {
"images": "array of image objects with title, url, and type fields",
"videos": "array of video objects with title, video_id, poster_url, streams, and type fields",
"vehicle": "string — vehicle name (e.g. '2026 Ford Ranger')",
"total_images": "integer — count of images returned",
"total_videos": "integer — count of videos returned"
},
"sample": {
"data": {
"images": [
{
"url": "https://www.assets.ford.com/adobe/assets/urn:aaid:aem:251ac8be-aa88-4a7d-b93d-0e866fd65d1d/as/26_FRD_RGR_FRDNTRKX0640_rapt_shelter_award.webp?max-quality=75&crop-names=1_3x4&width=900",
"type": "image",
"title": "2026 Ford Ranger® Raptor® model driving through a desert. Car and Driver 10Best 2026 logo in the upper right corner"
}
],
"videos": [
{
"type": "video",
"title": "Ford Ranger - Billboard",
"streams": {
"mobile": "https://www.ford.com/shared/videos/fv/ranger/2026/billboard_1_01052026/mobilefv/master.m3u8",
"tablet": "https://www.ford.com/shared/videos/fv/ranger/2026/billboard_1_01052026/tabletfv/master.m3u8",
"desktop": "https://www.ford.com/shared/videos/fv/ranger/2026/billboard_1_01052026/desktopfv/master.mpd"
},
"video_id": "billboard_1_01052026",
"poster_url": "https://www.ford.com/shared/videos/fv/ranger/2026/billboard_1_01052026/desktopfv/poster.jpeg"
}
],
"vehicle": "2026 Ford Ranger",
"total_images": 65,
"total_videos": 6
},
"status": "success"
}
}About the Ford API
What the API Returns
The get_gallery endpoint returns a complete snapshot of Ford's official 2026 Ranger media collection. The response includes a vehicle field identifying the model year and name, total_images and total_videos integer counts, an images array, and a videos array. Each image object carries a title, a url, and a type field. Each video object carries a title, a video_id, a poster_url for thumbnail display, a streams field with DASH and HLS URLs, and a type field.
Filtering by Media Type
The optional media_type input parameter lets you narrow the response to either images or videos. Omitting it returns both. This is useful when you only need streaming video metadata (DASH/HLS endpoints plus poster URLs) or only need the image set for a photo gallery without the overhead of video stream data in the payload.
Coverage and Freshness
The endpoint reflects what Ford currently publishes on the Ranger gallery page at ford.com — typically exterior angles, interior shots, color variants, feature callouts, and promotional video content. The data represents the live gallery, so model year updates or new media additions made by Ford will appear in subsequent calls. There is no historical archive of prior model years; the endpoint always returns the current published collection.
The Ford API is a managed, monitored endpoint for ford.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ford.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ford.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Populate a vehicle configurator or comparison tool with official Ranger imagery using image
urlandtitlefields. - Embed Ford's official Ranger promotional videos into a dealership website using DASH or HLS stream URLs from the
streamsfield. - Display video thumbnail previews in a media grid using
poster_urlbefore loading the full stream. - Build a media count dashboard that tracks how many images and videos Ford publishes for the Ranger over time using
total_imagesandtotal_videos. - Filter to only video content with the
media_typeparameter to feed a dedicated video section without fetching the full image set. - Sync a digital signage system at an auto showroom with the latest official Ranger media from Ford's gallery.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Ford have an official public developer API for gallery content?+
What does the `streams` field in a video object contain?+
streams field contains adaptive streaming URLs for the video in both DASH and HLS formats. You can pass either URL directly to a compatible video player. The poster_url field on the same object provides a still thumbnail image suitable for display before playback begins.Does the API cover Ranger trims or color-specific imagery separately?+
title and type rather than structured trim or color metadata. There is no separate filtering by trim level or exterior color within the current endpoint. You can fork this API on Parse and revise it to add trim-aware or color-tagged filtering if your use case requires it.