API integration
Show the course catalogue and the podcast episodes of We Are Motor in your app. Your affiliate link is included automatically in every course.
Checking access…
API access not enabled
API access is available to partners with a direct integration. If you have an app and want to show our courses, contact the team.
Contact the teamYour API key
Generate or regenerate your API access key. For security, it is shown only once.
Save it now: for security it will not be shown again. If you lose it, generate a new one with this button (the previous one will be invalidated).
If you already have an active key and press Generate, the previous one is invalidated instantly. Revoke cancels your current key without creating another: it stops working immediately (to get access again, generate a new one).
API documentation
The whole integration guide (endpoints, authentication, limits, examples and the rules for integrating it properly). Copy it and paste it into your AI so it can implement it right away.
Not sure what this is? Quick glossary
Endpoint: course catalogue
Call this endpoint to get the available courses with your personalised prices.
Endpoint: course catalogue
Call this endpoint to get the available courses with your personalised prices.
URL
GET https://somosmotor.es/v1/cursos
Responds in JSON. Public cache of 10 minutes (we recommend respecting the Cache-Control).
Authentication
Send your API key in either of these ways:
x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY Limits
60
req/min per API key
10 min
public cache of the feed
Response structure (example with your real data)
Loading example with your data… This example applies your real discount to a sample course of €180, so you can see exactly what the API returns. url_inscripcion already carries your ?ref= embedded.
Discount and commission are not the same thing. The discount (the one you see above in precio_con_descuento_eur) is what your customer saves for using your code. Your commission is what you earn on each sale: it does not travel in this feed (it is private), and you check it in your Commissions dashboard.
Example (curl)
curl -H "x-api-key: YOUR_API_KEY" \
https://somosmotor.es/v1/cursos Error codes
| Code | Meaning |
|---|---|
| 401 | Invalid or missing API key, or partner deactivated |
| 403 | API key without the "catalogo" scope |
| 429 | Too many requests (limit 60 req/min) |
| 500 | Internal error. Retry in a few seconds |
Endpoint: podcast episodes
Call this endpoint to get the published podcast episodes (MP3 audio + YouTube video).
Endpoint: podcast episodes
Call this endpoint to get the published podcast episodes (MP3 audio + YouTube video).
URL
GET https://somosmotor.es/v2/podcast
Responds in JSON. Public cache of 10 minutes (we recommend respecting the Cache-Control). Returns the episodes with published audio, from newest to oldest.
Authentication
Same API key as the courses endpoint. Send it in either of these ways:
x-api-key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY Limits
60
req/min per API key
10 min
public cache of the feed
Fields of each episode
| Field | What it is |
|---|---|
| id / slug | Unique identifier and slug of the episode |
| numero | Episode number |
| titulo / teaser | Title and short summary |
| fecha_publicacion | Date (YYYY-MM-DD) |
| invitados | List of the episode’s guests |
| imagen_url | Episode cover |
| duracion_segundos | Duration in seconds |
| audio_url | Stable MP3 of the audio (own player) |
| youtube_url | YouTube video (to embed with an iframe) |
| spotify_url / apple_podcasts_url / ivoox_url | Links to the platforms (if they exist) |
| url_episodio | Episode page on somosmotor.es (carries your ?ref=) |
Response structure (example with your real link)
Loading example… How to play the video
The video lives on YouTube (we do not serve video files). Take the ID from youtube_url and embed it with an iframe, just like on our website:
<iframe src="https://www.youtube.com/embed/VIDEO_ID?rel=0" allowfullscreen></iframe> To play only the audio, use audio_url (MP3) in your own player.
Example (curl)
curl -H "x-api-key: YOUR_API_KEY" \
https://somosmotor.es/v2/podcast Error codes
| Code | Meaning |
|---|---|
| 401 | Invalid or missing API key, or partner deactivated |
| 403 | API key without the "podcast" scope |
| 429 | Too many requests (limit 60 req/min) |
| 500 | Internal error. Retry in a few seconds |
Also available: public RSS
If you only want the standard audio feed (Spotify/Apple/iVoox), there is a public RSS 2.0 feed that does not require an API key:
GET https://somosmotor.es/podcast/rss.xml
How attribution works
- The user of your app taps “Enrol” on a course.
- Your app opens the
url_inscripcionfrom the feed in the device’s browser. - The user lands on
somosmotor.eswith your?ref=. The cookie is kept for 30 days. - We Are Motor handles the payment (Stripe). Your discount is applied automatically.
- The sale is attributed to your code. The commission appears in your affiliate dashboard.