ExTrends v0.1.0 ExTrends.RelatedTopics View Source

Google related topics operation

Users searching for your term also searched for these topics.

Link to this section Summary

Functions

To build related queries operation

Link to this section Functions

Link to this function

request(query)

View Source
request(%{
  :keyword => binary(),
  optional(:time) => binary(),
  optional(:geo) => binary(),
  optional(:hl) => binary(),
  optional(:tz) => binary(),
  optional(:prop) => binary(),
  optional(:cat) => integer()
}) :: ExTrends.Operation.RelatedTopics.t() | no_return()

To build related queries operation

Map keys:

  • keyword - string - the search term of interest.
  • time - Location of interest.
  • geo - geocode for a country, region, or DMA depending on the granularity required (defaults to worldwide). For example, geo: "US-CA-800" will target the Bakersfield, California, United States or geo: "US" will just target the US.
  • hl - Preferred language (defaults to en-US. Ref: language-codes)
  • tz - Timezone Offset from UTC in minutes. (defaults to 0)
  • prop - Google property to filter on. Defaults to web search. (enumerated string [images, news, youtube or froogle] where froogle is Google Shopping results)
  • cat - A number corresponding to a particular category to query within (defaults to all categories), see the category wiki for a complete list.

Time format

  • Date to start from

  • Defaults to last 5yrs, "today 5-y".

  • Everything "all"

  • Specific dates, "YYYY-MM-DD YYYY-MM-DD" example "2016-12-14 2017-01-25"

  • Specific datetimes, "YYYY-MM-DDTHH YYYY-MM-DDTHH" example "2017-02-06T10 2017-02-12T07"

    • Note Time component is based off UTC
  • Current Time Minus Time Pattern:

    • By Month: "today #-m" where # is the number of months from that date to pull data for

      • For example: "today 3-m" would get data from today to 3months ago
      • NOTE Google uses UTC date as "today"
      • Seems to only work for 1, 2, 3 months only
    • Daily: "now #-d" where # is the number of days from that date to pull data for

      • For example: "now 7-d" would get data from the last week
      • Seems to only work for 1, 7 days only
    • Hourly: "now #-H" where # is the number of hours from that date to pull data for

      • For example: "now 1-H" would get data from the last hour
      • Seems to only work for 1, 4 hours only

Examples

ExTrends.RelatedTopics.request(%{keyword: "virus"}) |> ExTrends.run()