Documentation

AI Client URLs

Promptmark’s “Run in” buttons let you send a prompt directly to supported AI clients with a single click. The prompt content is URL-encoded and passed as a query parameter.

Supported Clients

Client URL Pattern Param
Claude https://claude.ai/new?q={prompt} q
ChatGPT https://chatgpt.com/?prompt={prompt} prompt
Gemini https://google.com/search?udm=50&aep=11&q={prompt} q
Grok https://x.com/i/grok?text={prompt} text
Perplexity https://perplexity.ai/search/new?q={prompt} q
Nexus https://nexus.civic.com/?prompt={prompt} prompt

UTM Parameters

All URLs include tracking parameters:

utm_source=Promptmark.ai
utm_medium=Experimentation

These identify traffic coming from Promptmark without affecting the prompt content.

How It Works

  1. User clicks a “Run in” button on a prompt detail or public prompt page
  2. JavaScript encodes the prompt content with encodeURIComponent()
  3. A new browser tab opens with the constructed URL
  4. The target client receives the prompt as a pre-filled input

Links open with noopener,noreferrer for security.

Example

For the prompt “Explain quantum computing in simple terms”:

https://claude.ai/new?q=Explain%20quantum%20computing%20in%20simple%20terms&utm_source=Promptmark.ai&utm_medium=Experimentation

Template Variables

If the prompt contains template variables ({{name}}), the raw template text is sent. Users should render the template first (fill in variables) before using “Run in” buttons for the best experience.

Adding New Clients

To add a new AI client, the URL pattern needs:

  1. A base URL that accepts a prompt/query parameter
  2. The parameter name (e.g., q, prompt, text)
  3. Support for URL-encoded content

New clients are added in the template files under cmd/web/.