Crate rtrend[][src]

Expand description

rust-trend

This lib is a work in progress

Overview

Unofficial Rust API for interacting with Google Trend

Documentation

Example

First, add the dependency to your cargo.toml:

[dependencies]
rtrend = "0.1.3"

Then build a client and send the reqwest you want :

use rtrend::{Keywords, Country, Client, RegionInterest};
 
let country = Country::US;
let keywords = Keywords::new(vec!["Instagram","Facebook"]);
let client = Client::new(keywords, country).build();
 
// Then select the data you want. The interest of your keywords filtered by region for example:
let region_interest = RegionInterest::new(client).get();
println!("{}", region_interest);
 
// Result :
//{
//  "default": {
//    "geoMapData": [
//      {
//        "formattedValue": [
//          "100"
//        ],
//        "geoCode": "US-CA",
//        "geoName": "California",
//        "hasData": [
//          true
//        ],
//        "maxValueIndex": 0,
//        "value": [
//          100
//        ]
//      },
//
//      ...
//      
//      {
//        "formattedValue": [
//          "46"
//        ],
//        "geoCode": "US-SD",
//        "geoName": "South Dakota",
//        "hasData": [
//          true
//        ],
//        "maxValueIndex": 0,
//        "value": [
//          46
//        ]
//      }
//    ]
//  }
//}
 

More example

Roadmap

  • Write documentation & Doc Test
  • Release on crates.io
  • Add examples
  • Add “TOP” and “RISING” filter
  • Write more tests
  • Make async feature (currently using Reqwest::blocking)

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Re-exports

pub use client::Client;
pub use region_interest::RegionInterest;
pub use search_interest::SearchInterest;
pub use related_queries::RelatedQueries;
pub use related_topics::RelatedTopics;
pub use category::Category;
pub use country::Country;
pub use keywords::Keywords;
pub use lang::Lang;
pub use property::Property;
pub use period::Period;

Modules

Represent Google Trend Categories.

Client used to initialize everything needed by the Google Trend API.

Represent Google Trend Country.

A list of keywords to query on Google Trend Keywords is limited to a maximum of 5 keywords.

Represent all langage supported by google.

Represent period predefined by Google Trend.

Represent a Google Trend Property

Represent Google Trend geo maps.

Represent Google Trend Related Queries list.

Represent Google Trend Related Topics list.

Represent keywords interest over time.

Structs