AI engines
Microsoft Copilot API: official options and the scraping gap
Ten Microsoft 365 Copilot APIs run on Microsoft Graph, Retrieval at $0.10 per call. None returns the consumer Copilot answer, and scraping it is now banned.

By Mathias C.SEO consultant, and more recently GEO, at MentionBox
Microsoft does publish a Copilot API, and it answers a narrower question than the one most developers arrive with. The Microsoft 365 Copilot APIs are ten APIs served as REST endpoints under the Microsoft Graph namespaces graph.microsoft.com/v1.0/copilot and graph.microsoft.com/beta/copilot, and what they return is a Copilot answer for one signed-in, licensed user inside your own tenant. The only published per-call rate in the family is the Retrieval API pay-as-you-go preview, at $0.10 per API call. Nothing in it reports what the public assistant told somebody else, and since August 18, 2026 Microsoft's consumer terms forbid collecting that with a program.
This page is for the developer who searched for a Copilot endpoint shaped like OpenAI's and landed on a Graph permission list. Below: the products that share the name, the request that does return a web-grounded Copilot answer with its citations, and what is left for brand measurement now that the logged-out route has closed.
Three different products share the name
| What you are trying to do | The product to read | What it costs |
|---|---|---|
| Ask Microsoft 365 Copilot a question from your own app | Microsoft 365 Copilot APIs on Microsoft Graph: Chat, Retrieval, Search, Interaction Export, two change-notification APIs, Meeting Insights, usage reports, package management, Cost Management | no extra cost with a Microsoft 365 Copilot add-on licence; Retrieval alone has a pay-as-you-go rate of $0.10 per call |
| Call an agent you built yourself | Microsoft Copilot Studio, through the Direct Line channel or the Microsoft 365 Agents SDK | Copilot Studio licensing, not published per call |
| Ground your own model on Bing results | Grounding with Bing Search in Azure AI Foundry | $14 per 1,000 transactions, 150 per second, 1 million a day |
| Read the answer Copilot gave the public | nothing published by Microsoft | third-party collection, $1 to $13 per 1,000 answers |
API names and licensing from Microsoft Learn, read on November 9, 2026; third-party rates from our comparator, checked on October 23, 2026.
The request that returns a grounded answer with citations
The Chat API takes two calls. First a conversation, with an empty JSON body, which returns an id:
curl -X POST https://graph.microsoft.com/beta/copilot/conversations \
-H "Authorization: Bearer $GRAPH_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
Then the turn itself, where locationHint is required and contextualResources carries your files and the web toggle:
curl -X POST https://graph.microsoft.com/beta/copilot/conversations/$CONVERSATION_ID/chat \
-H "Authorization: Bearer $GRAPH_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"message": { "text": "best AI visibility API for an agency" },
"locationHint": { "timeZone": "America/New_York" },
"contextualResources": { "webContext": { "isWebEnabled": true } }
}'
Sources come back in an attributions array on each response message. Each entry carries an attributionType of annotation or citation, an attributionSource of model or grounding, and a seeMoreWebUrl pointing at the document or the page. Enterprise and web grounding are both on by default, and switching the web off is a single-turn action, repeated on every message where you do not want it.
Four constraints decide whether that is usable in a job:
- It is
/beta. Microsoft's own banner states that use of these APIs in production applications is not supported. - Delegated permissions only. Seven Graph permissions are required together, from
Sites.Read.AlltoExternalItem.Read.All, and application permissions are marked not supported, so an unattended daemon has no way in. - The answer is permission-trimmed. Two users in the same tenant can get different text for the same prompt, which is the point of the product and the end of any comparability.
- Text only. No file creation, no mail, no code interpreter, and long prompts are documented as prone to gateway timeouts.
Its siblings publish harder numbers: Retrieval and Search both cap a query at 1,500 characters and 200 requests per user per hour.
The public assistant, and the route that closed
For measuring what Copilot tells a prospect, none of the above applies, and 2026 made that harder rather than easier. Microsoft's Copilot Terms of Use, effective August 18, 2026, state that "To use Copilot you must have a Microsoft Account" and, among the prohibited behaviours, "Don't use bots or scrapers". Two consequences are on the record. Semrush told Enterprise AIO customers on October 28, 2026 that Copilot tracking would stop on November 9, 2026, citing access requirements that prevent visibility platforms from collecting the data, which takes its engine list from nine to eight. cloro's provider guide marks the engine "Discontinued. Copilot blocks access for logged-out sessions".
One Copilot-branded surface is still open to an anonymous visitor, and it is the one worth pointing a collector at: Copilot Search on Bing. cloro documents it as POST /v1/monitor/bing/aimode against bing.com/copilotsearch, returning result.text, result.sources and result.citationPills, for 4 credits a request against 5 for ChatGPT.
| Route to a Copilot answer | What it reads | Price per 1,000 answers |
|---|---|---|
| API for GEO | Copilot, listed among the engines it publishes, run natively in the country and language asked for | $13, down to $7 at its largest tier |
| Microsoft 365 Copilot Chat API | your tenant's Copilot, as one licensed user sees it | included with the Copilot add-on licence, /beta |
| Grounding with Bing Search | Bing results feeding your own agent, not a Copilot answer | $14 per 1,000 transactions |
| cloro, Bing AI Mode endpoint | the Copilot Search answer at bing.com/copilotsearch, with sources and citation pills | $4, on a Lite plan of $30 a month |
| Apify, Bright Data | the Copilot interface, listed by both vendors in our comparator | $1 and $1.50, raw answers with no computed metric |
Rates and engine lists from our comparator, checked on October 23, 2026; Microsoft rates from its own pages, read on November 9, 2026.
As a concrete example of the computed layer the official APIs leave out, API for GEO names Copilot among the engines on its own pages and returns brand mentions, position, share of voice, sentiment, cited sources and fan-out questions with each answer, at $13 per 1,000 answers down to $7 at its largest tier, above the scraping routes per answer. MentionBox, which publishes this site, has a commercial link with API for GEO.
Frequently asked questions
Is there an official Microsoft Copilot API?
Yes, ten of them, and they all answer inside your own Microsoft 365 tenant. Microsoft's overview page lists Chat, Retrieval, Search, Interaction Export, two change-notification APIs, Meeting Insights, Copilot usage reports, package management and Cost Management, served as REST endpoints under `graph.microsoft.com/v1.0/copilot` and `graph.microsoft.com/beta/copilot`. None of them returns the answer the public Copilot assistant gave to anyone outside your tenant.
How much does the Microsoft 365 Copilot API cost?
The Chat, Retrieval and Search APIs are free of extra charge for a user who already holds a Microsoft 365 Copilot add-on licence, which sits on top of an E3 or E5 subscription. The one published per-call rate is the Retrieval API pay-as-you-go preview, at $0.10 per API call, billed through an Azure subscription and limited to tenant-level sources such as SharePoint and Copilot connectors; OneDrive is excluded from that route, and your tenant still needs at least one Copilot licence to enable it.
Can the Copilot Chat API measure my brand's visibility?
No, for three reasons published in the documentation. The answer is permission-trimmed to the signed-in user, so two colleagues asking the same question can get different text; the endpoint supports delegated permissions only, with application permissions marked not supported, so no unattended job can run it; and nothing in the response holds a position, a share of voice or a count across repeated runs. Measuring the public assistant goes through a third-party API instead, at published rates from $1 to $13 per 1,000 answers.
Is scraping Microsoft Copilot allowed?
Microsoft's Copilot Terms of Use, effective August 18, 2026, say no twice over: "To use Copilot you must have a Microsoft Account", and "Don't use bots or scrapers". The practical effect arrived within three months. Semrush emailed Enterprise AIO customers on October 28, 2026 that Copilot tracking would end on November 9, 2026, taking its engine count from nine to eight, and cloro's provider guide now lists Copilot as discontinued because the site blocks logged-out sessions.
Which API still returns a Copilot-branded answer with its sources?
Two routes survive. The Copilot Search surface at bing.com/copilotsearch is still reachable without signing in, and cloro documents it at `POST /v1/monitor/bing/aimode`, returning `result.text`, `result.sources` and `result.citationPills` for 4 credits a request against 5 for ChatGPT, on a Lite plan of $30 a month and a rate of $4 per 1,000 answers. Platform APIs that listed Copilot in our comparator on October 23, 2026 are the other route, from $1 per 1,000 on Apify to $13 on API for GEO.
What is the difference between the Copilot APIs and the Microsoft Graph APIs?
Microsoft draws the line itself: the Graph APIs provide CRUD operations on Microsoft 365 data, while the Copilot APIs deliver AI capabilities built on that data. The split shows up in the bill, since Graph APIs run under standard Microsoft 365 licence terms and the Copilot APIs require the Copilot add-on licence. Both share the same authentication, the same conditional access rules and the same sensitivity labels, which is why permission trimming applies to every Copilot answer.