data-for-seo 0.2.0

Client library for the DataForSEO API v3 (SERP, Keywords Data, Labs, Backlinks, OnPage, and more)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

//! Business Listings endpoints of the Business Data API.
//! See <https://docs.dataforseo.com/v3/business_data/business_listings/overview/>.

use crate::api::business_data::BusinessDataApi;
use crate::entity::{
    BusinessDataApiBusinessListingsCategory, BusinessDataApiBusinessListingsLocation,
    BusinessDataApiBusinessListingsSearchRequest, BusinessDataApiBusinessListingsSearchResult,
    BusinessDataApiCategoriesAggregationRequest, BusinessDataApiCategoriesAggregationResult,
};
use crate::{DataForSeoApiResponse, DataForSeoClient};

impl BusinessDataApi<'_> {
    /// Returns the Business Listings sub-API of the Business Data domain.
    /// See <https://docs.dataforseo.com/v3/business_data/business_listings/overview/>.
    pub fn business_listings(&self) -> BusinessDataApiBusinessListings<'_> {
        BusinessDataApiBusinessListings {
            client: self.client,
        }
    }
}

/// Business Listings endpoints: search, aggregation, and reference data.
pub struct BusinessDataApiBusinessListings<'a> {
    client: &'a DataForSeoClient,
}

impl BusinessDataApiBusinessListings<'_> {
    /// Lists locations available for Business Listings search.
    /// See <https://docs.dataforseo.com/v3/business_data/business_listings/locations/>.
    pub async fn locations(
        &self,
    ) -> DataForSeoApiResponse<BusinessDataApiBusinessListingsLocation> {
        self.client
            .http_get("/v3/business_data/business_listings/locations")
            .await
    }

    /// Lists business categories available for filtering.
    /// See <https://docs.dataforseo.com/v3/business_data/business_listings/categories/>.
    pub async fn categories(
        &self,
    ) -> DataForSeoApiResponse<BusinessDataApiBusinessListingsCategory> {
        self.client
            .http_get("/v3/business_data/business_listings/categories")
            .await
    }

    /// Searches business listings synchronously.
    /// See <https://docs.dataforseo.com/v3/business_data/business_listings/search/live/>.
    pub async fn search_live(
        &self,
        data: Vec<BusinessDataApiBusinessListingsSearchRequest>,
    ) -> DataForSeoApiResponse<BusinessDataApiBusinessListingsSearchResult> {
        self.client
            .http_post("/v3/business_data/business_listings/search/live", &data)
            .await
    }

    /// Returns aggregated category statistics synchronously.
    /// See <https://docs.dataforseo.com/v3/business_data/business_listings/categories_aggregation/live/>.
    pub async fn categories_aggregation_live(
        &self,
        data: Vec<BusinessDataApiCategoriesAggregationRequest>,
    ) -> DataForSeoApiResponse<BusinessDataApiCategoriesAggregationResult> {
        self.client
            .http_post(
                "/v3/business_data/business_listings/categories_aggregation/live",
                &data,
            )
            .await
    }
}