---
title: "List EepURL activity"
method: GET
path: "/3.0/reports/{campaign_id}/eepurl"
tags: ["reports"]
---

# List EepURL activity

`GET /3.0/reports/{campaign_id}/eepurl`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/reports/{campaign_id}/eepurl`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.mailchimp.com/oauth2/authorize`
    - Token URL: `https://login.mailchimp.com/oauth2/token`
- TypeScript: <https://skmtc.dev/mailchimp/apis/mailchimp-api/docs/3.0/reports/:campaign_id/eepurl/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a summary of social activity for the campaign, tracked by EepURL.

## Path parameters

- `campaign_id` string, required

## Query parameters

- `fields` string[]
- `exclude_fields` string[]

## Response `200`

- object: A summary of social activity for the campaign, tracked by EepURL.
  - `_links` object[]: A list of link types and descriptions for the API schema documents.
    - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
    - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
    - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
    - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
    - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
  - `campaign_id` string: The unique id for the campaign.
  - `clicks` object: A summary of the click-throughs on the campaign's URL.
    - `clicks` integer: The total number of clicks to the campaign's URL.
    - `first_click` string, date-time: The timestamp for the first click to the URL.
    - `last_click` string, date-time: The timestamp for the last click to the URL.
    - `locations` object[]: A summary of the top click locations.
      - `country` string: The two-digit country code for a recorded click.
      - `region` string: If available, a specific region where the click was recorded.
  - `eepurl` string: The shortened link used for tracking.
  - `referrers` object[]: A summary of the top referrers for the campaign.
    - `clicks` integer: The number of clicks a single referrer generated.
    - `first_click` string, date-time: The timestamp for the first click from this referrer.
    - `last_click` string, date-time: The timestamp for the last click from this referrer.
    - `referrer` string: A referrer (truncated to 100 bytes).
  - `total_items` integer: The total number of items matching the query regardless of pagination.
  - `twitter` object: A summary of Twitter activity for a campaign.
    - `first_tweet` string: The day and time of the first recorded tweet with a link to the campaign.
    - `last_tweet` string: The day and time of the last recorded tweet with a link to the campaign.
    - `retweets` integer: The number of retweets that include a link to the campaign.
    - `statuses` object[]: A summary of tweets that include a link to the campaign.
      - `datetime` string, date-time: A timestamp for the tweet.
      - `is_retweet` boolean: A 'true' or 'false' status of whether the tweet is a retweet.
      - `screen_name` string: The Twitter handle for the author of the tweet.
      - `status` string: The body of the tweet.
      - `status_id` string: The individual id for the tweet.
    - `tweets` integer: The number of tweets including a link to the campaign.

## Other responses

- `default`: An error generated by the Mailchimp API.

---

[API](https://skmtc.dev/mailchimp/apis/mailchimp-api.md) - [All operations](https://skmtc.dev/mailchimp/apis/mailchimp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailchimp/apis/mailchimp-api/revisions/53bf4b156855?raw)