

````json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Advertising TCF API",
    "version": "1.0.0",
    "description": "## Overview\n\nThe Advertising TCF API provides access to Transparency and Consent Framework (TCF) data for Unity Ads.\n\nThe TCF is an industry-standard framework designed to help digital advertising participants comply with privacy regulations such as GDPR. It provides a standardized way to capture and communicate user consent preferences across the advertising ecosystem.\n\nThis API returns information about domains used by Unity Ads for advertising and tracking purposes, along with privacy disclosures required for TCF compliance.\n\n## Key Features\n\n* **Public Access**: No authentication required\n* **TCF Compliance**: Access to consent-related domain information\n* **Rate Limited**: Protected against excessive usage\n\n## Useful links\n\n* For general API usage, visit [Get Started](https://services.docs.unity.com/docs)\n* Learn more about [TCF Framework](https://iabeurope.eu/transparency-consent-framework/)\n",
    "contact": {
      "name": "Unity Ads Support",
      "url": "https://docs.unity.com/",
      "email": "support@unity3d.com"
    }
  },
  "tags": [
    {
      "name": "TCF",
      "description": "Transparency and Consent Framework endpoints"
    }
  ],
  "servers": [
    {
      "url": "https://services.api.unity.com/advertise/developer/v1"
    }
  ],
  "paths": {
    "/tcf.json": {
      "get": {
        "summary": "Get TCF Data",
        "description": "Retrieves Transparency and Consent Framework (TCF) data for Unity Ads.\n\n## About This Endpoint\n\nThis endpoint provides access to TCF-compliant consent information, which is essential for ensuring GDPR compliance in digital advertising. The TCF standard enables transparent communication of user consent preferences across the advertising supply chain.\n\n## Authentication\n\nThis is a **public endpoint** and does not require authentication. It can be accessed by any client without credentials.\n\n## Rate Limiting\n\nTo protect service availability, this endpoint is rate-limited:\n- **Production**: 10 requests per second, 18,000 requests per 30 minutes (per IP address)\n- **Staging**: 20 requests per second, 36,000 requests per 30 minutes (per IP address)\n\nIf you exceed these limits, you will receive a `429 Too Many Requests` response.\n\n## Response Data\n\nThe endpoint returns:\n- **disclosures**: Array of privacy disclosures (currently empty, future enhancements planned)\n- **domains**: List of domains used by Unity Ads for advertising and tracking purposes\n- **sdks**: List of SDKs used by Unity Ads for advertising and tracking purposes\n\n## Usage Example\n\n```bash\ncurl https://services.api.unity.com/advertise/developer/v1/tcf.json\n```\n\nResponse:\n```json\n{\n  \"disclosures\": [],\n  \"domains\": [\n    {\n      \"domain\": \"*.unityads.unity3d.com\",\n      \"use\": \"Ad server and tracking\"\n    },\n    {\n      \"domain\": \"*.isx.unity3d.com\",\n      \"use\": \"Ad server and tracking\"\n    }\n  ],\n  \"sdks\": [\n    {\n      \"name\": \"com.unity3d.ads\",\n      \"use\": \"Advertising and Tracking\"\n    },\n    {\n      \"name\": \"com.tapjoy.Tapjoy\",\n      \"use\": \"Advertising and Tracking\"\n    },\n    {\n      \"name\": \"com.unity3d.ads-mediation\",\n      \"use\": \"Advertising and Tracking\"\n    },\n    {\n      \"name\": \"com.ironsource.adqualitysdk.sdk\",\n      \"use\": \"Advertising and Tracking\"\n    }\n  ]\n}\n```\n",
        "operationId": "advertise-getTCF",
        "tags": [
          "TCF"
        ],
        "responses": {
          "200": {
            "description": "Successfully retrieved TCF data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TCFResponse"
                },
                "example": {
                  "disclosures": [],
                  "domains": [
                    {
                      "domain": "*.unityads.unity3d.com",
                      "use": "Ad server and tracking"
                    },
                    {
                      "domain": "*.isx.unity3d.com",
                      "use": "Ad server and tracking"
                    },
                    {
                      "domain": "*.iads.unity3d.com",
                      "use": "Ad server and tracking"
                    },
                    {
                      "domain": "*.tapjoy.net",
                      "use": "Ad server and tracking"
                    },
                    {
                      "domain": "*.tapjoy.com",
                      "use": "Ad server and tracking"
                    }
                  ],
                  "sdks": [
                    {
                      "name": "com.unity3d.ads",
                      "use": "Advertising and Tracking"
                    },
                    {
                      "name": "com.tapjoy.Tapjoy",
                      "use": "Advertising and Tracking"
                    },
                    {
                      "name": "com.unity3d.ads-mediation",
                      "use": "Advertising and Tracking"
                    },
                    {
                      "name": "com.ironsource.adqualitysdk.sdk",
                      "use": "Advertising and Tracking"
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests - Rate limit exceeded"
          },
          "500": {
            "description": "Internal Server Error"
          },
          "503": {
            "description": "Service Unavailable"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "TCFResponse": {
        "type": "object",
        "description": "TCF (Transparency and Consent Framework) data for Unity Ads",
        "properties": {
          "disclosures": {
            "type": "array",
            "description": "List of privacy disclosures",
            "items": {
              "type": "object"
            }
          },
          "domains": {
            "type": "array",
            "description": "List of domains used by Unity Ads with their purposes",
            "items": {
              "$ref": "#/components/schemas/Domain"
            }
          },
          "sdks": {
            "type": "array",
            "description": "List of SDKs used by Unity Ads for advertising and tracking",
            "items": {
              "$ref": "#/components/schemas/SDK"
            }
          }
        },
        "required": [
          "disclosures",
          "domains"
        ]
      },
      "SDK": {
        "type": "object",
        "description": "An SDK used by Unity Ads",
        "properties": {
          "name": {
            "type": "string",
            "description": "SDK package name",
            "example": "com.unity3d.ads"
          },
          "use": {
            "type": "string",
            "description": "Purpose of the SDK usage",
            "example": "Advertising and Tracking"
          }
        },
        "required": [
          "name",
          "use"
        ]
      },
      "Domain": {
        "type": "object",
        "description": "A domain used by Unity Ads",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Domain name (may include wildcards)",
            "example": "*.unityads.unity3d.com"
          },
          "use": {
            "type": "string",
            "description": "Purpose of the domain usage",
            "example": "Ad server and tracking"
          }
        },
        "required": [
          "domain",
          "use"
        ]
      }
    }
  }
}
````