ottobock.com APIottobock.com ↗
Access Ottobock's prosthetic and orthotic product catalog, technical specs, clinic finder, and newsroom articles via 9 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/7004377f-f0b7-4e84-9856-103b2244c366/search_products?page=0&limit=2&query=knee' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Ottobock by keyword using Algolia index. Returns paginated results with product names, codes, descriptions, and category paths.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-based) |
| limit | integer | Results per page |
| queryrequired | string | Search keyword (e.g. 'knee', 'prosthetic hand') |
{
"type": "object",
"fields": {
"hits": "array of product objects with code, onlineCode, name_en, description_en, categoryPath_en, previewImageUrl",
"page": "integer current page number",
"nbHits": "integer total number of matching products",
"nbPages": "integer total number of pages"
},
"sample": {
"data": {
"hits": [
{
"code": "3R93",
"name_en": "Knee joint with friction brake, monocentric, with lock",
"onlineCode": "3R93-60877",
"previewImageUrl": "https://res.cloudinary.com/ottobock-se/image/upload/..."
}
],
"page": 0,
"nbHits": 42,
"nbPages": 3
},
"status": "success"
}
}About the ottobock.com API
The Ottobock API covers 9 endpoints that expose the full product catalog, technical specifications, media assets, newsroom content, and a clinic locator from ottobock.com. Use search_products to query prosthetics and orthotics by keyword and get paginated results including product codes, English descriptions, category paths, and preview image URLs. Product detail endpoints return structured specs, gallery images, and document links tied to each product's unique onlineCode slug.
Product Catalog and Search
The search_products endpoint accepts a query string (e.g. 'knee', 'prosthetic hand') and returns paginated hits with fields including code, onlineCode, name_en, description_en, categoryPath_en, and previewImageUrl. Pagination uses 0-based page and a limit parameter; the response also returns nbHits and nbPages so you can walk the full result set. To browse by category instead of keyword, get_product_category accepts a category_id (e.g. '32355' for Knees) and returns the same hit shape filtered to that branch of the taxonomy.
Product Detail, Specs, and Media
Once you have a product's onlineCode slug, three endpoints give progressively deeper data. get_product_detail returns the full HTML description, a categoryPath array, and a customerData object that bundles gallery items, documents, tableTechnicalData, and functionalities. get_product_specifications isolates the spec tables—tableTechnicalData, tableTaxonomyAttributes (product type, mobility grade, user group), and tableHighlightAttributes—all as HTML strings. get_product_images returns galleryItems (each with thumbnailUrl, detailUrl, zoomUrl, altText), galleryVideo objects, and a productImage map with primary, zoom, thumbnail, and cart-sized URLs.
Clinic Finder and Navigation
find_clinics queries the Ottobock certified clinic directory. Pass a query string (city, state, or zip code) to filter results; omit it to retrieve all clinics. Each hit includes locationName, street, city, state, zipCode, phone, websiteLink, and _geoloc with latitude and longitude suitable for map rendering. list_categories returns the full site navigation tree for a given type ('Solutions', 'Services', 'Resources', or 'Newsroom'), with nested label, url, and children arrays—useful for building category browsers or feeding category IDs into get_product_category.
Newsroom
get_newsroom_articles returns a list of press releases and news entries, each with a headline, topline date/label, rich-text body, and a primaryButton link to the full article. To retrieve a complete article, get_newsroom_article_detail accepts an article slug and returns the full fields object including pageTitle, metaDescription, pageContent rich text, stage imagery, and sys timestamps for creation and last update.
- Build a product comparison tool using
get_product_specificationsto pulltableTaxonomyAttributeslike mobility grade and user group side-by-side. - Populate a prosthetics catalog app by paginating
search_productsresults and displayingpreviewImageUrlandcategoryPath_en. - Render a clinic locator map using
find_clinicswith the_geoloclat/lng fields from each clinic hit. - Monitor Ottobock press releases by polling
get_newsroom_articlesfor newheadlineandtoplineentries. - Seed a product database with full media assets by combining
get_product_imagesgallery and video fields for eachonlineCodeslug. - Generate a browsable category tree for a rehab-tech directory using
list_categorieswith the'Solutions'type and its nestedchildren. - Enrich a rehabilitation provider platform by cross-referencing
find_clinicsresults withget_product_categoryitems relevant to a patient's device type.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Ottobock offer an official public developer API?+
What does `get_product_detail` return beyond what `search_products` provides?+
search_products returns a lightweight hit with code, name_en, description_en, categoryPath_en, and previewImageUrl. get_product_detail adds the full HTML description, a structured categoryPath array, and the customerData object, which includes galleryItems, documents, tableTechnicalData, and functionalities—data that is not included in search results.How does pagination work across the product endpoints?+
search_products and get_product_category use 0-based page indexing. The response always includes nbHits (total matching records) and nbPages (total pages at the current limit), so you can iterate through the full result set by incrementing page until you reach nbPages - 1.Does the API return product pricing or availability/stock status?+
Are non-English product names and descriptions available?+
name_en, description_en, categoryPath_en). Localized variants in other languages are not currently exposed. You can fork this API on Parse and revise it to surface additional language fields if they are available in the underlying data.