API reference · Prompts

Get a prompt

One prompt: metrics, brands, sources, latest answers.

Ask Claude Ask ChatGPT

GET/api/v1/domains/{domain}/prompts/{prompt_id}

Path parameters

domainstringRequired

The domain's host, like acme.example, or its ID. List them with List domains.

prompt_idstringRequired

A prompt's id, from List prompts.

Query parameters

rangestringdefault 30d

How far back to count: 7d, 30d, 90d or all. The previous period is the same length, just before.

7d30d90dall

surfacestring

Limit to one surface, written engine:lane, e.g. chatgpt_app:chat.

topicstring

Limit to prompts in one topic (exact name).

brandedstringdefault unbranded

Whether to count prompts that name your brand: unbranded (default), all or branded.

unbrandedallbranded

Returns

promptstring

The question.

kpisobject

The same headline numbers as Get metrics, for this prompt.

brandsarray

Brands named in its answers, with visibility.

surfacesarray

Per surface: visibility, change, citations and position.

sourcesarray

The ten sites cited most, with their top URLs.

latest_answersarray

Every answer from the latest run.

Every response includes the domain and the filters that were applied. Errors use the standard error object.

import requests r = requests.get( "https://getonym.com/api/v1/domains/acme.example/prompts/14686699-b479-4cf1-9b02-c9232ae704bc", headers={"Authorization": "Bearer YOUR_API_KEY"}, ) r.raise_for_status() data = r.json()

const r = await fetch( "https://getonym.com/api/v1/domains/acme.example/prompts/14686699-b479-4cf1-9b02-c9232ae704bc", { headers: { Authorization: "Bearer YOUR_API_KEY" } } ); const data = await r.json();

{ "domain": "acme.example", "prompt": "Best auth provider for a B2B app that needs SAML SSO and SCIM", "topic": "Enterprise SSO", "kpis": { "visibility": { "k": 10, "n": 28, "rate": 0.357, "low": 0.207, "high": 0.542, "change": { "delta": 0.186, "significant": false, "direction": "flat", "pairs": 7, "prev": { "k": 6, "n": 35, "rate": 0.171, "low": 0.081, "high": 0.327 }, "cur": { "k": 10, "n": 28, "rate": 0.357, "low": 0.207, "high": 0.542 } } }, "citations": { "k": 9, "n": 28, "rate": 0.321, "low": 0.179, "high": 0.507, "change": { "delta": 0.15, "significant": false, "direction": "flat", "pairs": 7, "prev": { "k": 6, "n": 35, "rate": 0.171, "low": 0.081, "high": 0.327 }, "cur": { "k": 9, "n": 28, "rate": 0.321, "low": 0.179, "high": 0.507 } } }, "sov": { "k": 10, "n": 45, "rate": 0.222, "prev": 0.107 }, "position": { "avg": 1.8, "n": 10, "prev": 2.0, "cur_common": 1.8, "top1": 4 }, "sentiment": { "n": 10, "positive": 6, "neutral": 4, "negative": 0 }, "answers": 28, "prompts": 1, "runs": 4 }, "brands": [ { "id": "f0feb797-5b9c-49eb-a97f-4a8cb662701f", "name": "Northwind", "you": false, "domain": "northwind.example", "visibility": { "k": 15, "n": 28, "rate": 0.536, "low": 0.358, "high": 0.705 }, "change": { "delta": 0.136, "significant": false, "direction": "flat", "pairs": 7, "prev": { "k": 14, "n": 35, "rate": 0.4, "low": 0.256, "high": 0.564 }, "cur": { "k": 15, "n": 28, "rate": 0.536, "low": 0.358, "high": 0.705 } }, "sov": 0.333, "position": 1.3, "spark": [ 0.571, 0.571 ] }, { "id": "fd21b437-b4e4-4972-84a4-573d64d06cfb", "name": "Globex", "you": false, "domain": "globex.example", "visibility": { "k": 12, "n": 28, "rate": 0.429, "low": 0.265, "high": 0.609 }, "change": { "delta": -0.229, "significant": false, "direction": "flat", "pairs": 7, "prev": { "k": 23, "n": 35, "rate": 0.657, "low": 0.492, "high": 0.792 }, "cur": { "k": 12, "n": 28, "rate": 0.429, "low": 0.265, "high": 0.609 } }, "sov": 0.267, "position": 1.9, "spark": [ 0.714, 0.143 ] } ], "surfaces": [ { "key": "chatgpt_app:chat", "label": "ChatGPT", "method": "app", "visibility": { "k": 2, "n": 4, "rate": 0.5, "low": 0.15, "high": 0.85 }, "change": { "delta": 0.3, "significant": false, "direction": "flat", "pairs": 1, "prev": { "k": 1, "n": 5, "rate": 0.2, "low": 0.036, "high": 0.624 }, "cur": { "k": 2, "n": 4, "rate": 0.5, "low": 0.15, "high": 0.85 } }, "citations": { "k": 2, "n": 4, "rate": 0.5, "low": 0.15, "high": 0.85 }, "position": 1.5 }, { "key": "openai:coding", "label": "Codex", "method": "api", "visibility": { "k": 2, "n": 4, "rate": 0.5, "low": 0.15, "high": 0.85 }, "change": { "delta": 0.5, "significant": false, "direction": "flat", "pairs": 1, "prev": { "k": 0, "n": 5, "rate": 0.0, "low": 0.0, "high": 0.434 }, "cur": { "k": 2, "n": 4, "rate": 0.5, "low": 0.15, "high": 0.85 } }, "citations": { "k": 0, "n": 4, "rate": 0.0, "low": 0.0, "high": 0.49 }, "position": 2.0 } ], "sources": [ { "host": "reddit.com", "kind": "other", "owner": "", "type": "UGC & community", "answers": 15, "share": 0.536, "prompts": 1, "with_you": 4, "gap": 10, "trend": "flat", "urls": [ { "url": "https://www.reddit.com/r/nextjs/comments/1a2b3c/which_auth_provider_do_you_use/", "count": 12 }, { "url": "https://www.reddit.com/r/SaaS/comments/9x8y7z/auth_for_b2b/", "count": 9 } ] }, { "host": "authcompare.example", "kind": "other", "owner": "", "type": "Editorial & other", "answers": 15, "share": 0.536, "prompts": 1, "with_you": 4, "gap": 10, "trend": "up", "urls": [ { "url": "https://authcompare.example/best-auth-providers-2026", "count": 15 } ] } ], "latest_answers": [ { "id": "1f628fa3-9551-4c03-bf8c-4e59f663fbb6", "run_date": "2026-10-11", "prompt_id": "14686699-b479-4cf1-9b02-c9232ae704bc", "prompt": "Best auth provider for a B2B app that needs SAML SSO and SCIM", "topic": "Enterprise SSO", "surface": "chatgpt_app:chat", "surface_label": "ChatGPT", "method": "app", "named_you": false, "your_position": null, "brands": [ "Northwind" ], "citations": [ "https://www.youtube.com/watch?v=authshootout", "https://www.g2.com/categories/customer-identity-and-access-management" ] }, { "id": "85a97eab-5ce3-4826-aaa7-2a6ad405db5b", "run_date": "2026-10-11", "prompt_id": "14686699-b479-4cf1-9b02-c9232ae704bc", "prompt": "Best auth provider for a B2B app that needs SAML SSO and SCIM", "topic": "Enterprise SSO", "surface": "openai:coding", "surface_label": "Codex", "method": "api", "named_you": false, "your_position": null, "brands": [ "Globex" ], "citations": [ "https://www.reddit.com/r/nextjs/comments/1a2b3c/which_auth_provider_do_you_use/", "https://www.g2.com/categories/customer-identity-and-access-management" ] } ] }