# gpodder.net API

**Canonical:** https://apis.io/apis/gpodder/gpodder-api/  
**Provider:** gpodder.net — https://apis.io/providers/gpodder/  
**Base URL:** https://gpodder.net  
**Documentation:** https://gpoddernet.readthedocs.io/en/latest/api/reference/auth.html

gpodder.net API is published by [gpodder.net](https://apis.io/providers/gpodder/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

gpodder.net API as documented publicly: 18 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/2/data/podcast.json` | Retrieve Podcast Data |
| POST | `/api/2/devices/a-user/somedevice-123.json` | Update Device Data |
| POST | `/api/2/episodes/some-user.json` | Episode Actions API — gpodder.net documentation |
| GET | `/api/2/favorites` | Get Favorite Episodes |
| GET | `/api/2/settings` | Get Settings |
| POST | `/api/2/settings` | Save Settings |
| GET | `/api/2/sync-devices/ ( username ) .json` | Get Sync Status |
| POST | `/api/2/sync-devices/ ( username ) .json` | Start / Stop Sync |
| GET | `/search` | Podcast Search |
| GET | `/search.json` | Carries out a service-wide search for podcasts that match the given query. |
| GET | `/search.opml` | Carries out a service-wide search for podcasts that match the given query. |
| GET | `/search.txt` | Carries out a service-wide search for podcasts that match the given query. |
| GET | `/subscriptions/bob.opml` | Get All Subscriptions |
| GET | `/subscriptions/bob/asdf.opml` | Get Subscriptions of Device |
| PUT | `/subscriptions/john/e9c4ea4ae004efac40.txt` | Upload Subscriptions of Device |
| GET | `/suggestions` | Retrieve Suggested Podcasts |
| GET | `/suggestions/10.opml` | Retrieve Suggested Podcasts |
| GET | `/toplist/50.json` | Get the top 50 list in JSON format |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/gpodder/openapi/_ae-authored/gpodder-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/gpodder/json-schema/gpodder-post-api2-episodes-some-user-json-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/gpodder/json-schema/gpodder-get-api2-favorites-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/gpodder/json-schema/gpodder-get-toplist50-json-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/gpodder/json-schema/gpodder-get-suggestions10-opml-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/gpodder/json-schema/gpodder-get-suggestions-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/gpodder/json-schema/gpodder-get-api2-data-podcast-json-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/gpodder/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gpodder/gpodder-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gpodder/.