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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

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

use crate::api::business_data::BusinessDataApi;
use crate::entity::{
    BusinessDataApiTaskReady, BusinessDataApiTripadvisorReviewsResult,
    BusinessDataApiTripadvisorReviewsTaskPost, BusinessDataApiTripadvisorSearchResult,
    BusinessDataApiTripadvisorSearchTaskPost, SerpApiLanguage,
};
use crate::{DataForSeoApiResponse, DataForSeoClient, SerpApiLocation};
use serde_json::Value;

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

/// Tripadvisor endpoints: Search and Reviews.
pub struct BusinessDataApiTripadvisor<'a> {
    client: &'a DataForSeoClient,
}

impl BusinessDataApiTripadvisor<'_> {
    /// Lists Tripadvisor locations supported by the Business Data API.
    /// See <https://docs.dataforseo.com/v3/business_data/tripadvisor/locations/>.
    pub async fn locations(&self) -> DataForSeoApiResponse<SerpApiLocation> {
        self.client
            .http_get("/v3/business_data/tripadvisor/locations")
            .await
    }

    /// Lists Tripadvisor languages supported by the Business Data API.
    /// See <https://docs.dataforseo.com/v3/business_data/tripadvisor/languages/>.
    pub async fn languages(&self) -> DataForSeoApiResponse<SerpApiLanguage> {
        self.client
            .http_get("/v3/business_data/tripadvisor/languages")
            .await
    }

    /// Sets Tripadvisor Search tasks.
    /// See <https://docs.dataforseo.com/v3/business_data/tripadvisor/search/task_post/>.
    pub async fn search_task_post(
        &self,
        data: Vec<BusinessDataApiTripadvisorSearchTaskPost>,
    ) -> DataForSeoApiResponse<Value> {
        self.client
            .http_post("/v3/business_data/tripadvisor/search/task_post", &data)
            .await
    }

    /// Lists completed Tripadvisor Search tasks.
    /// See <https://docs.dataforseo.com/v3/business_data/tripadvisor/search/tasks_ready/>.
    pub async fn search_tasks_ready(&self) -> DataForSeoApiResponse<BusinessDataApiTaskReady> {
        self.client
            .http_get("/v3/business_data/tripadvisor/search/tasks_ready")
            .await
    }

    /// Retrieves a completed Tripadvisor Search task by id.
    /// See <https://docs.dataforseo.com/v3/business_data/tripadvisor/search/task_get/>.
    pub async fn search_task_get(
        &self,
        id: &str,
    ) -> DataForSeoApiResponse<BusinessDataApiTripadvisorSearchResult> {
        self.client
            .http_get(&format!(
                "/v3/business_data/tripadvisor/search/task_get/{id}"
            ))
            .await
    }

    /// Sets Tripadvisor Reviews tasks.
    /// See <https://docs.dataforseo.com/v3/business_data/tripadvisor/reviews/task_post/>.
    pub async fn reviews_task_post(
        &self,
        data: Vec<BusinessDataApiTripadvisorReviewsTaskPost>,
    ) -> DataForSeoApiResponse<Value> {
        self.client
            .http_post("/v3/business_data/tripadvisor/reviews/task_post", &data)
            .await
    }

    /// Lists completed Tripadvisor Reviews tasks.
    /// See <https://docs.dataforseo.com/v3/business_data/tripadvisor/reviews/tasks_ready/>.
    pub async fn reviews_tasks_ready(&self) -> DataForSeoApiResponse<BusinessDataApiTaskReady> {
        self.client
            .http_get("/v3/business_data/tripadvisor/reviews/tasks_ready")
            .await
    }

    /// Retrieves a completed Tripadvisor Reviews task by id.
    /// See <https://docs.dataforseo.com/v3/business_data/tripadvisor/reviews/task_get/>.
    pub async fn reviews_task_get(
        &self,
        id: &str,
    ) -> DataForSeoApiResponse<BusinessDataApiTripadvisorReviewsResult> {
        self.client
            .http_get(&format!(
                "/v3/business_data/tripadvisor/reviews/task_get/{id}"
            ))
            .await
    }
}