Topics API: experiment and participate
Quick guide to implement and test the API. Access topics with JavaScript and share your feedback.
Learn the essentials
- Topics API overview introduces the API and explains the issues it addresses.
- Topic classification explains the classifier model, how topics are inferred and assigned to users' browsers, and how users can control their topics list.
- The Topics API developer guide covers setup, getting and setting topics using JavaScript and headers, and debugging.
Try the API
Not all users may be eligible for the Privacy Sandbox Relevance and Measurement origin trial, even on pages that provide a valid trial token.
Testing the Privacy Sandbox ads relevance and measurement APIs explains why this is so, and shows how you can (and should) detect if an origin trial feature is available before attempting to use it.
- Check the Privacy Sandbox status page for updates on the implementation status of the Topics API.
- Experiment with the API:
- Learn how to take part in the Privacy Sandbox Relevance and Measurement origin trial.
- Try out Topics for a single user in Chrome 101 or above by enabling
chrome://flags/#privacy-sandbox-ads-apis
or by running Chrome from the command line with the--enable-features=PrivacySandboxAdsAPIsOverride
feature flag. Refer to Topics API demos. - Use the Topics JavaScript API to access topics provides a short code example to demonstrate how the API might be used to access topics observed for the current user.
Get support
Is anything blocking you from experimenting with the API? Ask a question about your implementation or about the documentation:
- Open a new issue on the Privacy Sandbox Dev Support repository. Make sure to select the issue template for Topics.
- For more general questions about how to meet your use cases with the API, file an issue on the proposal repository.
For bugs and issues with the implementation of the Topics API in Chrome:
- View existing issues reported for the API.
- Raise a new issue at crbug.com/new.
Join the discussion
Everyone is welcome to join in discussion of the Topics proposal. In particular, if you're experimenting with the API, your feedback is essential.
Discuss the API
Like other Privacy Sandbox proposals, this API is documented and discussed publicly.
- Read the proposal explainer on GitHub.
- Join the conversation about existing issues.
- Open a new issue to ask a question, propose a feature, or discuss a use case.
Discuss related topics
- Discuss industry use cases in the Improving Web Advertising Business Group.
Give feedback
- Use the Privacy Sandbox feedback form to share feedback privately with the Chrome team outside of public forums.
- Privacy Sandbox Feedback explains how to provide other types of feedback, and how to engage in discussion of Privacy Sandbox proposals.
Get updates
- To be notified of status changes in the API, join the mailing list for developers.
- To closely follow all ongoing discussions on the API, click the Watch button on the proposal page on GitHub. This requires you have or create a GitHub account.
- To get overall updates on the Privacy Sandbox, subscribe to the RSS feed Progress in the Privacy Sandbox.