dataforseo-client

What it is and what it does

dataforseo-client is an auto-generated Python wrapper around the DataForSEO REST API, eliminating the need to manually construct HTTP requests and parse responses. It provides typed access to 12 API sections covering search engine results pages (SERP), keyword research, domain analytics, backlinks, on-page analysis, and several other SEO and business intelligence tools. The client abstracts two request patterns: synchronous live requests (simple HTTP request/response) and asynchronous task-based requests (submit a task, poll for readiness, retrieve results).

The library depends on urllib3 for HTTP transport, python-dateutil for timestamp handling, pydantic for data validation, and typing-extensions for type hints. It is actively maintained, with recent releases and no known security vulnerabilities. The package is generated from an OpenAPI specification, meaning its API surface is large and closely mirrors the upstream DataForSEO service documentation.

Use it for:

• Retrieve live SERP rankings for a keyword in a specific location and language without building raw HTTP requests.
• Submit long-running domain analytics or backlink analysis tasks and poll for completion in a structured way.
• Integrate SEO data collection into a Python application without manually handling authentication, request serialization, or response parsing.
• Analyze on-page content metrics and merchant data using typed request/response objects that validate input before sending.
• Build a monitoring or reporting tool that queries multiple DataForSEO APIs (keywords, domain analytics, business data) in a single codebase.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for the DataForSEO REST API, handling request construction, response parsing, and authentication for SEO data retrieval across 12 API sections including SERP, keywords, domain analytics, backlinks, and more.

Yes, if you need to integrate DataForSEO's SEO and business intelligence APIs into a Python application. Install friction is low, maintenance is active, and there are no known vulnerabilities. However, resolve the unclear license status before use in commercial or copyleft-sensitive contexts, and ensure you have valid DataForSEO API credentials and understand their rate limits.

Install

dataforseo-client on PyPI

pip install dataforseo-client

uv add dataforseo-client

poetry add dataforseo-client

Installing dataforseo-client

Before you install

Low install friction with four lightweight runtime dependencies (urllib3, python-dateutil, pydantic, typing-extensions). Package is actively maintained with a release 3 days old and recent commits.

License in practice

License treatment is unclear—no SPDX identifier or raw license text is declared in the package metadata. Before relying on this package in a commercial or copyleft-sensitive project, verify the actual license from the GitHub repository.

Quickstart

from dataforseo_client import configuration, api_client
from dataforseo_client.api.serp_api import SerpApi
from dataforseo_client.models.serp_google_organic_live_advanced_request_info import SerpGoogleOrganicLiveAdvancedRequestInfo

config = configuration.Configuration(username='USERNAME', password='PASSWORD')
with api_client.ApiClient(config) as client:
    api = SerpApi(client)
    response = api.google_organic_live_advanced([SerpGoogleOrganicLiveAdvancedRequestInfo(
        language_name="English",
        location_name="United States",
        keyword="example"
    )])

Requires DataForSEO API credentials (username and password) to authenticate; API calls are subject to DataForSEO's rate limits and service availability.

Verify before relying

• Minimum Python version requirement is not specified in the fact sheet.
• Whether the package supports async/await patterns for concurrent requests beyond the task-based polling shown in examples.
• Scope and limitations of the 12 API sections (e.g., which require task-based vs. live requests, rate limits per section).

Package facts

Evidence: dataforseo_client-2.1.3-py3-none-any.whl

Keywords: OpenAPI, DataForSEO, DataForSEO API documentation

Tags

More WWW/HTTP packages