Skip to content

DataForSEO

Backlinks Timeseries Summary

‌ This endpoint will provide you with an overview of backlink data for the target domain available during a period between the two indicated dates. Backlink metrics will be grouped by the time range that you define: day, week, month, or year.

Usage based DataForSEOSEOdataforseo/backlinks-timeseries-summaryActive

Use this tool with your agent

Give this to your agent
Use my connected Agentik MCP server. I want to use the tool dataforseo/backlinks-timeseries-summary (Backlinks Timeseries Summary). Call inspect_tool with {"tool_id": "dataforseo/backlinks-timeseries-summary"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "dataforseo/backlinks-timeseries-summary" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If the tool is unavailable, say so and use discover_tools to propose an alternative.
Show the prompt

Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.

Parameters

NameTypeRequiredDescription
targetstringYesdomain to get data for required field a domain should be specified without https:// and www. example: "forbes.com"
date_fromstringNostarting date of the time range optional field this field indicates the date which will be used as a threshold for summary data;minimum value: 2019-01-30 maximum value shouldn't exceed the date specified in the date_to date format: "yyyy-mm
date_tostringNoending date of the time range optional field if you don't specify this field, the today's date will be used by default minimum value shouldn't preceed the date specified in the date_from maximum value: today's date date format: "yyyy-mm-dd"
group_rangestringNotime range which will be used to group the results optional field default value: month possible values: day, week, month, yearnote: for day, we will return items corresponding to all dates between and including date_from and date_to; for we
include_subdomainsbooleanNoindicates if the subdomains of the target will be included in the search optional field if set to false, the subdomains will be ignored default value: true
rank_scalestringNodefines the scale used for calculating and displaying the rank, domain_from_rank, and page_from_rank values optional fieldyou can use this parameter to choose whether rank values are presented on a 0–100 or 0–1000 scalepossible values: one_
tagstringNouser-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response

How your agent calls it

First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:

{
  "tool_id": "dataforseo/backlinks-timeseries-summary",
  "input": {
    "target": "dataforseo.com",
    "date_from": "2021-12-01",
    "date_to": "2022-02-01",
    "group_range": "month"
  }
}

Price and billing

Price
Usage based
Model
Usage based
Detail
Billed at the cost the provider reports for the call, never above $100. Your agent sees the maximum before running.
  • The provider’s price, 0% markup.
  • One prepaid balance for every provider; your agent sees the price before it runs.
  • Pay for measured usage; unused reservations are released.