Get Daily Traffic Data by Segment

GET

https://apigw.seomonitor.com/v3/organic-traffic/v3.0/daily-traffic

This endpoint returns the organic traffic metrics by day for a traffic segment over a specified timeframe.

The data returned includes the number of sessions, conversions, bounce rate, and revenue.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

campaign_id

integer

required

(Required) This parameter specifies the ID of the campaign for which you want to return data.

Please refer to the Quick Start Guide to learn how to retrieve the IDs of your campaigns.

Example:

start_date

string

required

(Required) This parameter specifies the start date of the timeframe for which you want to return the data, in YYYY-MM-DD format.

Example:

end_date

string

required

(Required) This parameter specifies the end date of the timeframe for which you want to return the data, in YYYY-MM-DD format.

Example:

segment

string

optional

The name assigned to the segment in the platform.
Accepted values are all, non-brand, brand, or the name of a custom traffic segment created in the SEOmonitor platform, e.g. "blog".

Unless otherwise specified, data will be returned for the Non-Brand segment by default.

Example:

Header Params

string

required

Example:

application/json

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET 'https://apigw.seomonitor.com/v3/organic-traffic/v3.0/daily-traffic?campaign_id={{campaign_id}}&start_date={{start_date}}&end_date={{end_date}}&segment={{segment}}' \
--header 'Accept: application/json' \
--header 'Authorization;'

Responses

🟢200Success

application/json

Body

date

string

optional

The date for which the traffic data is being returned, in YYYY-MM-DD format.

sessions

integer

optional

The sum of sessions for the specified traffic segment, if the campaign is connected to both Google Search Console and Google Analytics – or clicks, if the campaign is only connected to Google Search Console, on the date within the selected timeframe.

ecommerce

object

optional

Parent field containing ecommerce transaction data including number of conversions and the revenue generated by the keywords in the specific traffic segment.

conversions

integer

optional

The sum of conversions uncovered through the (not provided) solution on the date within the selected timeframe.

revenue

integer

optional

The sum of ecommerce revenue uncovered through the (not provided) solution on the specified date within the selected timeframe.

goals

object

optional

Parent field containing goals transaction data including the number of completions and the revenue generated by the keywords in the specified segment.

completions

integer

optional

The total number of goal completions uncovered through the (not provided) solution for the selected goals for the date within the selected timeframe.

revenue

integer

optional

The goal revenue uncovered through the (not provided) solution for the selected goals on the date within the selected timeframe.

bounce_rate

number

optional

The percentage of single-page sessions for the website segment on the specified date.

Example

[
  {
    "date": "2023-01-07",
    "sessions": 508000,
    "ecommerce": {
      "conversions": 1512,
      "revenue": 97000
    },
    "goals": {
      "completions": 865,
      "revenue": 83000
    },
    "bounce_rate": 0.3
  }
]

Modified at 2024-11-05 13:58:32

Get Daily Share of Clicks

Get Traffic Data by Keywords