This is the tool you call when you want "who ranks for this." You get organic results, video results, ads when we have them, a resultType on rows, recommendedActions, fetchedAt, and a hasEmail hint when a contact is already on file.
Keyword input may arrive URL-encoded. The server decodes it.
Arguments
| Name | Type | Required |
|---|---|---|
keyword | string, 1–200 characters | Yes |
languageCode | string, optional | No |
locationCode | positive integer, optional | No |
Example
{
"keyword": "best ai presentation maker"
}Freshness
If the newest snapshot is under 30 days old, you get that copy. If it is older, LinkDR may refresh it from DataForSEO. If refresh is limited or fails, you get no_snapshot or whatever we still have stored. Treat no_snapshot as "no usable SERP," not as a live blank Google page.
Keep fan-out to about five keywords. You rarely need more in one turn.
Contacts
hasEmail is not the email. Follow with get_contacts using the result URL or the publisher host. For creators, search_creators is the fallback when you only have a name.