Skip to content

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.

Two white arch shapes stand on a pale floor beside a solid blue sphere

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 doThe product to readWhat it costs
Ask Microsoft 365 Copilot a question from your own appMicrosoft 365 Copilot APIs on Microsoft Graph: Chat, Retrieval, Search, Interaction Export, two change-notification APIs, Meeting Insights, usage reports, package management, Cost Managementno 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 yourselfMicrosoft Copilot Studio, through the Direct Line channel or the Microsoft 365 Agents SDKCopilot Studio licensing, not published per call
Ground your own model on Bing resultsGrounding 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 publicnothing published by Microsoftthird-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.All to ExternalItem.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 answerWhat it readsPrice per 1,000 answers
API for GEOCopilot, 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 APIyour tenant's Copilot, as one licensed user sees itincluded with the Copilot add-on licence, /beta
Grounding with Bing SearchBing results feeding your own agent, not a Copilot answer$14 per 1,000 transactions
cloro, Bing AI Mode endpointthe Copilot Search answer at bing.com/copilotsearch, with sources and citation pills$4, on a Lite plan of $30 a month
Apify, Bright Datathe 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.