> ## Documentation Index > Fetch the complete documentation index at: https://docs.particle.pro/llms.txt > Use this file to discover all available pages before exploring further. # Get a publisher's brand suitability profile > Returns a publisher-level rollup of IAB Tech Lab Brand Safety & Suitability Framework (formerly GARM) verdicts across the publisher's catalog: tier composition (SAFE / LIMITED / SENSITIVE / UNSAFE), confidence distribution, per-category exposure across all 12 GARM dimensions, and the top concerns surfaced from the category rollup. The coverage block (analyzed_coverage as a 0..1 share + a LOW/MEDIUM/HIGH quality enum) tells callers how representative the rollup is — analyses are still being backfilled across the long tail of the catalog. Identify the publisher by slug (e.g., 'iheartpodcasts', 'bbc-radio-4', 'bloomberg') or ID. ## OpenAPI ````yaml /openapi.json get /v1/podcasts/publishers/{id}/suitability openapi: 3.1.0 info: description: Public API for Particle — news intelligence, financial data, and analysis. title: Particle API version: 0.1.0 servers: - url: https://api.particle.pro security: - ApiKeyHeader: [] - BearerAuth: [] paths: /v1/podcasts/publishers/{id}/suitability: get: tags: - Podcast Publishers - tier:premium summary: Get a publisher's brand suitability profile description: >- Returns a publisher-level rollup of IAB Tech Lab Brand Safety & Suitability Framework (formerly GARM) verdicts across the publisher's catalog: tier composition (SAFE / LIMITED / SENSITIVE / UNSAFE), confidence distribution, per-category exposure across all 12 GARM dimensions, and the top concerns surfaced from the category rollup. The coverage block (analyzed_coverage as a 0..1 share + a LOW/MEDIUM/HIGH quality enum) tells callers how representative the rollup is — analyses are still being backfilled across the long tail of the catalog. Identify the publisher by slug (e.g., 'iheartpodcasts', 'bbc-radio-4', 'bloomberg') or ID. operationId: get-publisher-suitability parameters: - description: >- Podcast publisher slug (e.g., 'iheartpodcasts', 'bbc-radio-4', 'bloomberg') or ID. Slugs are the recommended identifier. in: path name: id required: true schema: description: >- Podcast publisher slug (e.g., 'iheartpodcasts', 'bbc-radio-4', 'bloomberg') or ID. Slugs are the recommended identifier. type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/PublisherSuitabilityProfile' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/PlatformError' description: Error x-codeSamples: - label: cURL lang: curl source: |- curl -H "X-API-Key: $PARTICLE_API_KEY" \ "https://api.particle.pro/v1/podcasts/publishers/{id}/suitability" components: schemas: PublisherSuitabilityProfile: additionalProperties: false properties: category_breakdown: description: >- Per-GARM-category roll-up across the publisher's analyzed catalog. Always 12 entries in canonical order so callers don't need to merge against the canonical category list. For an analyzed publisher with no exposure in a given category, none equals analyzed_podcasts and every other bucket is 0; only when the publisher has zero analyzed podcasts are all five prevalence buckets 0. items: $ref: '#/components/schemas/PublisherSuitabilityCategoryBreakdown' type: - array - 'null' confidence_breakdown: $ref: '#/components/schemas/PublisherSuitabilityConfidenceBreakdown' description: >- How confident the agent was in the verdicts that produced this rollup, summed across analyzed podcasts. coverage: $ref: '#/components/schemas/PublisherSuitabilityCoverage' description: Catalog size and how much of it has been analyzed. last_evaluated_at: description: >- Most recent evaluation timestamp across the publisher's analyses. Omitted when the publisher has zero analyzed podcasts. format: date-time type: string publisher: $ref: '#/components/schemas/PodcastPublisherCompact' description: The publisher whose catalog is summarized. tier_breakdown: $ref: '#/components/schemas/PublisherSuitabilityTierBreakdown' description: >- Distribution of analyzed podcasts across the four IAB/GARM tiers (SAFE, LIMITED, SENSITIVE, UNSAFE), with counts and shares. top_concerns: description: >- Up to three highest-exposure GARM categories ranked by high_risk_count, surfaced separately so advertisers can scan the publisher's worst dimensions without traversing the full breakdown. items: $ref: '#/components/schemas/PublisherSuitabilityTopConcern' type: - array - 'null' required: - publisher - coverage - tier_breakdown - confidence_breakdown - category_breakdown type: object PlatformError: additionalProperties: false properties: detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string error_code: type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string resolve: $ref: '#/components/schemas/ErrorResolve' status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object PublisherSuitabilityCategoryBreakdown: additionalProperties: false properties: code: description: >- Brand-safety category code (IAB Tech Lab Content Taxonomy 3.x): adult_sexual, arms_ammunition, crime_harmful_acts, death_injury_military_conflict, online_piracy, hate_speech_aggression, obscenity_profanity, illegal_drugs_alcohol_tobacco, spam_harmful, terrorism, debated_social_issues, misinformation. type: string description: description: Human-readable description of the category. type: string exposure_share: description: >- Share of analyzed podcasts with any non-NONE prevalence in this category (0..1). format: double type: number frequent: description: Number where the category appears FREQUENTLY. format: int64 type: integer glamorizing: description: >- Number whose category row carries GLAMORIZING treatment (the most advertiser-toxic treatment). format: int64 type: integer high_risk_count: description: >- Number of analyzed podcasts with FREQUENT/PERVASIVE prevalence or GLAMORIZING treatment in this category — the advertiser-relevant 'this is a real problem' count. format: int64 type: integer incidental: description: >- Number where this category appears INCIDENTALLY (1-2 references in the analyzed window). format: int64 type: integer none: description: Number of analyzed podcasts where this category is absent. format: int64 type: integer occasional: description: Number where the category appears OCCASIONALLY. format: int64 type: integer pervasive: description: Number where the category is PERVASIVE. format: int64 type: integer promotional: description: >- Number of analyzed podcasts whose category row carries PROMOTIONAL treatment (endorsement without celebration). format: int64 type: integer required: - code - description - none - incidental - occasional - frequent - pervasive - promotional - glamorizing - high_risk_count - exposure_share type: object PublisherSuitabilityConfidenceBreakdown: additionalProperties: false properties: high: description: Number with HIGH confidence. format: int64 type: integer low: description: Number of analyzed podcasts whose verdict carries LOW confidence. format: int64 type: integer medium: description: Number with MEDIUM confidence. format: int64 type: integer required: - low - medium - high type: object PublisherSuitabilityCoverage: additionalProperties: false properties: analyzed_coverage: description: >- analyzed_podcasts / total_podcasts, clamped to [0, 1]. Treat as a confidence proxy for the rolled-up verdict. format: double type: number analyzed_podcasts: description: >- Number of catalog podcasts that have an IAB/GARM suitability analysis. format: int64 type: integer quality: description: >- Qualitative read on how representative the rollup is given current analysis coverage: LOW (< 0.3), MEDIUM (0.3-0.7), HIGH (>= 0.7). type: string total_podcasts: description: >- Total number of non-deleted podcasts attributed to this publisher (denormalized from podcast_publishers.podcast_count). format: int64 type: integer required: - total_podcasts - analyzed_podcasts - analyzed_coverage - quality type: object PodcastPublisherCompact: additionalProperties: false properties: id: description: Publisher ID type: string name: description: Publisher name type: string slug: description: >- Human-readable slug identifier (e.g., 'goalhanger', 'iheartpodcasts'). When present, accepted in place of the ID anywhere a publisher reference is taken in the API. Occasionally absent on publishers whose name doesn't slugify (e.g., scripts not representable in ASCII URL slugs). type: string required: - id - name type: object PublisherSuitabilityTierBreakdown: additionalProperties: false properties: limited: description: Number assigned LIMITED (Medium Risk). format: int64 type: integer limited_share: description: Share assigned LIMITED (0..1). format: double type: number placeable_share: description: >- Combined SAFE + LIMITED share (0..1) — the 'broadly buyable' slice an advertiser without category restrictions can typically reach. format: double type: number safe: description: Number of analyzed podcasts assigned the SAFE (Low Risk) tier. format: int64 type: integer safe_share: description: Share of analyzed podcasts assigned SAFE (0..1). format: double type: number sensitive: description: Number assigned SENSITIVE (High Risk). format: int64 type: integer sensitive_share: description: Share assigned SENSITIVE (0..1). format: double type: number unsafe: description: Number assigned UNSAFE (Brand Safety Floor). format: int64 type: integer unsafe_share: description: Share assigned UNSAFE (0..1). format: double type: number required: - safe - limited - sensitive - unsafe - safe_share - limited_share - sensitive_share - unsafe_share - placeable_share type: object PublisherSuitabilityTopConcern: additionalProperties: false properties: code: description: GARM category code. type: string description: description: Human-readable category description. type: string exposure_share: description: >- Share of analyzed podcasts with any non-NONE prevalence in this category (0..1). format: double type: number high_risk_count: description: FREQUENT+PERVASIVE or GLAMORIZING count for this category. format: int64 type: integer required: - code - description - high_risk_count - exposure_share type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object ErrorResolve: additionalProperties: false properties: action: type: string endpoint: type: string message: type: string method: type: string url: type: string required: - message type: object securitySchemes: ApiKeyHeader: description: Pass your API key in the X-API-Key header (recommended). in: header name: X-API-Key type: apiKey BearerAuth: description: Pass your API key as a Bearer token in the Authorization header. scheme: bearer type: http ````