Microsoft
Microsoft search ads API
Search ads in the Microsoft ads library. Call the Microsoft search ads API and get JSON back in one request. 1 credit per call. Failed calls cost nothing.
POST
Search ads in the Microsoft ads library
Searches ads in the Microsoft ads library.
Request
This method has no required parameters.Response
If successful, the response body contains the standard envelope.data.results[] contains the ads, each with its advertiser, headline and text.
The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.
Optional parameters
Billing
Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.Pagination
Results are paginated. To retrieve the next page, pass the value ofdata.cursor as cursor in a subsequent request. A response that omits cursor is the last page.
Related methods
- Microsoft ads search: Accepts an
advertiserIdasadvertiser. Searches ads in the Microsoft ads library. - Microsoft ad details: Accepts
adId. Returns a Microsoft ad’s details.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Required string length:
1 - 200Pattern:
^\d{1,20}$EU/EEA country code like de. Microsoft publishes ads for these countries only. Any case is accepted.
Pattern:
^[A-Za-z]{2}$The cursor from the previous response. Send it as is.
Minimum string length:
1