Projects & markets

A project is a workspace scoped to a set of markets. It decides which countries and languages the app shows you, holds your tracked entities, trends and publishers, and carries its own plan, API keys and team. Everything you do in the app — the Explorer, the Tracking counts, the dashboards — is read through the lens of the project you have open. Most teams run one project per market strategy: a single project covering the countries they care about, or a few projects that split coverage by brand, region or client.

This guide covers what lives inside a project, how to create one and switch between them from the top-bar project switcher, how to choose the markets and languages you monitor, and how to invite teammates. The market and language you pick here are the defaults that flow into the Explorer filters and the API region parameter, so it is worth getting them right up front.

#What a project scopes

Open a project and the whole app narrows to it. In particular, a project owns:

• Markets — the countries and languages you monitor. The switcher shows the project name and a N COUNTRIES badge so you always know how wide your current view is.
• Tracking lists — the entities, trends, categories, publishers and mentions you have put on your radar, each with its own live count in the sidebar TRACKING section.
• Publisher Center — the sites you have connected and the drafts and published pieces your team is working on.
• Plan & API access — the tier (shown next to Plan, e.g. PRO) and the API keys issued under Project → API Access.
• Team — the people invited to the project, managed under Project → Users.

#Create a project

You create and open projects from the project switcher in the top bar.

1. Open the project switcher
   In the top bar, click the current project name (the control that shows the name and the N COUNTRIES badge). It opens a menu listing every project you can access.
2. Start a new project
   Choose to create a new project from the switcher menu, then give it a name that reflects its scope — a market, a brand or a client works well, since the name is what your team sees in the switcher.
3. Pick the markets you'll monitor
   Select the countries and languages this project should cover. This set is what the N COUNTRIES badge counts, and it seeds the default market and language across the app.
4. Open it and start tracking
   The new project becomes your active context. Head to the Discover explorer to read the feed, or add entities, trends and publishers to your TRACKING lists to build up your radar.

#Switch between projects

The same top-bar control switches context. Click the project name, pick another project from the menu, and the entire app re-scopes to it — the Explorer, the TRACKING counts, the Publisher Center and the PROJECT section all reload for the project you selected. The N COUNTRIES badge updates so you can confirm at a glance which markets you're now looking at.

#Choose markets & languages

The market and language on a project are the same two dimensions you filter by everywhere else, so they behave consistently across the app and the API:

• Market — a country, identified by its ISO alpha-2 code (us, de, …). A project can span several countries; the badge counts them.
• Language — the language of the articles you want to read. Discover is polled per language and region, so the same country can surface different content by language.

In the Discover explorer, the filter bar opens on your project's market (a flag plus the country name) and language. You can change them there for a one-off view — pick a different country or language, set a time window with the 24H, 7D, 14D, 30D or Custom buttons, or use the compare toggle — without changing the project itself.

The API takes the same market on its region parameter: pass an ISO alpha-2 country code, or all for a global view. So a country you monitor in a project is the same value you send to the API.

# Same market as your project, now over the API
curl "https://d2tr.com/api/v1/trends?region=us" \
  -H "X-API-Key: $D2TR_API_KEY"

#Invite your team

Teammates are added per project, so everyone you invite lands in the same market scope with the same tracking lists and dashboards.

1. Open Project → Users
   With the right project active, go to Project → Users in the sidebar. Confirm the project name in the switcher first — invitations apply to the active project.
2. Invite by email
   Add a teammate by email address. They join this project and see exactly the markets it covers.
3. Switch projects to manage another team
   Each project keeps its own member list. To manage a different team, switch to that project in the top bar and open its Project → Users.

#Next steps

With a project set up and your markets chosen, put the app to work: read the live feed, build your radar, and query the same markets over the API.