Skip to main content
ARouter supports optional HTTP headers that identify your application in API requests. These headers are used for source tracking in the ARouter Dashboard โ€” giving you per-app analytics and usage breakdowns across multiple projects or workflows under a single account.

Headers

HTTP-Referer

Your applicationโ€™s URL. Used to identify the source of the request.
HTTP-Referer: https://myapp.com

X-Title

Your applicationโ€™s display name. Shows up in your Dashboard activity view.
X-Title: My AI App

Implementation

Include these headers in any request to the ARouter API:
from openai import OpenAI

client = OpenAI(
    base_url="https://api.arouter.ai/v1",
    api_key="lr_live_xxxx",
    default_headers={
        "HTTP-Referer": "https://myapp.com",
        "X-Title": "My AI App",
    },
)

response = client.chat.completions.create(
    model="openai/gpt-5.4",
    messages=[{"role": "user", "content": "Hello!"}],
)

App Categories

Categorize your application to appear correctly in ARouterโ€™s analytics:
CategoryDescription
CodingDeveloper tools, IDEs, code assistants
CreativeWriting, image generation, art tools
ProductivityDocument processing, summarization, automation
ResearchKnowledge retrieval, analysis, academic tools
EntertainmentGames, chat, roleplay
OtherAnything that doesnโ€™t fit the above
Pass the category as part of your X-Title header or as a dedicated header if supported by your integration. The category appears in your Dashboard analytics alongside the app name.

Dashboard Activity

When you include attribution headers, the ARouter Dashboard displays:
  • App Name: Shown in the activity feed and analytics per request
  • Source URL: Used to group requests by application domain
  • Category: Appears in usage breakdowns by app type
  • Per-app usage: Token consumption, cost, and request volume per attributed app
This is especially useful when:
  • Managing multiple applications under one account
  • Running A/B tests across different app versions
  • Understanding which workflows drive the most usage

Benefits of Attribution

  • Usage breakdown by app โ€” See which of your applications consumes the most tokens and cost
  • Traffic analysis โ€” Understand request volume patterns per app
  • Optimization signals โ€” Identify high-cost workflows for optimization
Attribution headers are ARouter-side only and do not affect model behavior, routing, or the upstream provider.