# Get Team Podcasts

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Teams
> Source: https://www.podengine.ai/api-docs/get-team-podcasts.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/get-team-podcasts
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `http://localhost:4000`
**Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY`

---

#### GET /api/v1/teams/podcasts
**Get Team Podcasts**

Get all podcasts associated with your team

```bash
curl -X GET "http://localhost:4000/api/v1/teams/podcasts?limit=10&offset=0" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Query schema:**
```json
{
  "type": "object",
  "properties": {
    "blacklist": {
      "type": "boolean"
    },
    "sync": {
      "type": "boolean"
    },
    "hasAirtableError": {
      "type": "boolean"
    },
    "limit": {
      "default": 100,
      "type": "number",
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "type": "number"
    },
    "textFilter": {
      "description": "Can be a partial podcast title, apple id, apple podcast url, or airtable record id",
      "type": "string"
    },
    "sortOrder": {
      "type": "string",
      "enum": [
        "podcastTitle",
        "addedAt",
        "lastAirtableSync"
      ]
    }
  },
  "required": [
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number"
        },
        "totalFiltered": {
          "type": "number"
        },
        "teamPodcasts": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "addedByUserId": {
                "nullable": true,
                "type": "string"
              },
              "addedReason": {
                "type": "string",
                "enum": [
                  "add-to-team-podcasts-button",
                  "listed-podcast",
                  "migration",
                  "script",
                  "search-export"
                ]
              },
              "blacklist": {
                "type": "boolean"
              },
              "createdAt": {},
              "podcast": {
                "type": "object",
                "properties": {
                  "author": {
                    "nullable": true,
                    "type": "string"
                  },
                  "authorityScore": {
                    "nullable": true,
                    "type": "object",
                    "properties": {
                      "calculatedAt": {},
                      "authorityScore": {
                        "type": "number",
                        "description": "This is the weighted total authority score of the podcast, out of 100"
                      },
                      "qualityScore": {
                        "type": "number",
                        "description": "This is the quality score of the podcast, out of 100"
                      },
                      "youtubeScore": {
                        "type": "number",
                        "description": "This is the YouTube score of the podcast, out of 100"
                      },
                      "socialScore": {
                        "type": "number",
                        "description": "This is the social score of the podcast, out of 100"
                      },
                      "engagementScore": {
                        "type": "number",
                        "description": "This is the engagement score of the podcast, out of 100"
                      }
                    },
                    "required": [
                      "calculatedAt",
                      "authorityScore",
                      "qualityScore",
                      "youtubeScore",
                      "socialScore",
                      "engagementScore"
                    ],
                    "additionalProperties": false
                  },
                  "genres": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "id": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "nullable": true,
                    "type": "string"
                  },
                  "language": {
                    "type": "string"
                  },
                  "lastEpisodePublishedAt": {},
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "titleLatest": {
                    "type": "string"
                  }
                },
                "required": [
                  "author",
                  "authorityScore",
                  "genres",
                  "id",
                  "imageUrl",
                  "language",
                  "lastEpisodePublishedAt",
                  "slug",
                  "title",
                  "titleLatest"
                ],
                "additionalProperties": false
              },
              "podcastId": {
                "type": "string"
              },
              "projects": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "projectId": {
                      "type": "string"
                    },
                    "addedByUserId": {
                      "type": "string"
                    },
                    "listedPodcastState": {
                      "type": "string",
                      "enum": [
                        "prospect",
                        "qualified",
                        "pitched",
                        "lost",
                        "booked",
                        "ignored"
                      ]
                    }
                  },
                  "required": [
                    "projectId",
                    "addedByUserId",
                    "listedPodcastState"
                  ],
                  "additionalProperties": false
                }
              },
              "sync": {
                "type": "boolean"
              },
              "teamId": {
                "type": "string"
              },
              "lastAirtableSync": {},
              "lastAirtableErrorSyncDate": {},
              "airtableRecordId": {
                "type": "string"
              }
            },
            "required": [
              "addedByUserId",
              "addedReason",
              "blacklist",
              "createdAt",
              "podcast",
              "podcastId",
              "projects",
              "sync",
              "teamId"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "total",
        "totalFiltered",
        "teamPodcasts"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status",
    "data"
  ],
  "additionalProperties": false
}
```

---

## See also

- All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt
- Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt
- OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json
- Get an API key: https://www.podengine.ai/get-started
- Support: support@podengine.ai