Skip to main content

​
Source Attribution

Emby supports an optional X-Source header that lets you identify your application or domain when making requests. This enables transparent, privacy-safe public usage statistics that help the ecosystem understand how Emby is being used. No content, user data, or sensitive information is ever shared — only anonymized, aggregated counts.

​
X-Source Header

Add the header to any request: 
curl -X POST https://api.emby.dev/v1/chat/completions \
  -H "Authorization: Bearer $EMBY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Source: example.com" \
  -d '{
    "model": "deepseek-v3",
    "messages": [
      {"role": "user", "content": "Hello, how are you?"}
    ]
  }'

​
Accepted Formats

You can pass your domain in any of the following ways — Emby will normalize them automatically:
  • example.com
  • https://example.com
  • https://www.example.com
  • www.example.com
All forms are converted to the base domain (example.com) for aggregation.

​
What We Publish (Public Stats)

Aggregated, privacy-safe stats help the Emby community understand adoption and model usage across the ecosystem.

Popular Domains

See which applications and tools are building on Emby.

Model Usage Trends

Understand which models developers prefer over time.

Regional Adoption

High-level (country-level) geographic distribution.

Growth Metrics

Track ecosystem expansion across industries and communities.

​
Privacy Considerations

Emby is built for EU-first teams, with strict privacy controls.
Here is exactly what is and isn’t collected.

​
✅ What’s Public

Only anonymized, aggregated data:
  • Base domain (e.g. example.com)
  • Request counts
  • Model usage totals
  • Country-level geolocation

​
❌ What’s Private

Never collected, logged, or shared:
  • Request bodies or content
  • User identifiers
  • Code, prompts, or responses
  • Personal data of any kind
  • API keys or tokens
  • Detailed behavioral patterns
Your data never leaves the EU unless you explicitly route to a non-EU provider.

​
Why Use X-Source?

Using the X-Source header is optional but recommended — it helps the community and benefits your project.

Showcase Your Project

Your domain appears in public usage stats, highlighting your work.

Build Credibility

Demonstrate real-world adoption to users or customers.

Support Transparency

Help the open-source ecosystem understand model adoption.

Inspire Developers

Others can discover your app and learn from your implementation.

​
Optional — But Encouraged

Adding the header:
  • Supports an open and transparent AI ecosystem
  • Helps track community growth
  • Makes it clear which tools are succeeding
  • Requires zero additional configuration
Your participation contributes to a healthier, more collaborative AI infrastructure ecosystem.
Need help?
Chat with us on WhatsApp: https://wa.absolum.nl
Or book a call: https://cal.com/absolum/30min