Back to catalog

Se Ranking · Seo Aeo

SE Ranking Data API / Get paid ads by keyword

Retrieves an overview of paid advertisements (PPC ads) run by various domains for a specific target keyword. The method shows which domains are advertising on that keyword, the extent of their advertising efforts over a period, and details of their ad creatives. Cost at SE Ranking: 100 credits per request.

Live data

You are looking at the live public catalog.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • from query · optional

    Starting year and month for the data retrieval period, formatted as YYYY-MM (e.g., 2017-01).

  • keyword query · required

    Specific keyword for which to retrieve paid ad data. Accepts any valid keyword string (e.g., new york hotels).

  • limit query · optional

    Maximum number of domains advertising on the specified keyword to return per page. Accepts values from 1 to 100 (e.g., 20).

  • page query · optional

    Page number for paginated results when retrieving domains advertising on the specified keyword (e.g., 1). Positive integer.

  • source query · required

    Country code of the regional keyword database (e.g., us). For acceptable values, see Regional database codes.

  • to query · optional

    Ending year and month for the data retrieval period, formatted as YYYY-MM (e.g., 2023-12).

No allowlisted official documentation or pricing reference is available.

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.