Who is bidding against this page
get_competitorsCosts nothing. Returns the competitor layer of a finished audit: the competitors bidding on the same clicks, the live ads Google is serving for each of them with the keyword, search volume and CPC behind every one, the landing pages those ads click to, which competitor advertises most, the advertisers currently on this page's own keyword, and the customer's own paid keyword count. The ad and keyword numbers are measured from the DataForSEO ads index, not written by a model, so they are safe to quote as figures. The competitor page summaries and the head-to-head read ARE written by the audit and are judgement, not measurement. Competitor page captures are attached where the scan reached them. Needs a completed audit. An audit that found nobody returns that plainly, which is a real answer and not a failure. Older audits carry no ad data at all. ask_audit with topic:competitors is the one for the written comparison; this is the one for the numbers. Safe to read again; it does not start new work.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"audit_id": "<audit_id>"
},
"name": "get_competitors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| audit_id | Yes |