Get outreach data

Returns citation opportunities for the specified brand. These are high-impact recommendations for citation wins, including:

• Low-hanging fruit: Existing articles where competitors are cited but your brand isn’t
• Publication gaps: High-value domains that could be pitched for new articles

Opportunities include detailed analysis, pitch templates, contact information, and strategic recommendations. Results are sorted by priority score and paginated.

GET /get-outreach

Get outreach data

cURL

curl --request GET \
  --url https://api.trakkr.ai/get-outreach \
  --header 'Authorization: Bearer <token>'

200

{
  "brand_id": "1749113348709x432280934699237400",
  "opportunities": [
    {
      "_id": "1751366661128x982280299254958800",
      "unique_key": "low-hanging-fruit:forbes.com/best-running-shoes-2025",
      "opportunity_type": "low-hanging-fruit",
      "url": "https://www.forbes.com/best-running-shoes-2025",
      "domain": "forbes.com",
      "title": "Best Running Shoes for Marathon Training in 2025",
      "status": "New",
      "difficulty": "Medium",
      "priority_score": 92,
      "fit_score": 88,
      "pitch_subject": "Nike's Innovation in Sustainable Marathon Footwear",
      "competitors": [
        "Adidas",
        "Hoka One One",
        "ASICS"
      ],
      "contact_emails": [
        "[e-mail]"
      ],
      "last_seen_date": "2025-11-13T10:30:00Z"
    },
    {
      "_id": "1751366662000x123456789012345600",
      "unique_key": "publication-gap:wired.com:sustainability",
      "opportunity_type": "publication-gap",
      "domain": "wired.com",
      "title": "Pitch: Sustainable Running Shoes Innovation Story",
      "status": "New",
      "difficulty": "Hard",
      "priority_score": 78,
      "fit_score": 82,
      "weak_prompt": "best sustainable running shoes",
      "competitors_winning": [
        "Allbirds",
        "Veja"
      ],
      "last_seen_date": "2025-11-13T10:30:00Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "has_more": false,
    "next_cursor": null
  }
}

Authorizations

Authorization · string · header · required

API key authentication. Include your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY

Query Parameters

brand · string · required

The brand ID (32-character hexadecimal string)

Required string length: 32

Pattern: ^[0-9a-fx]{32}$

opportunity_type · enum<string>

Filter by opportunity type

Available options: low-hanging-fruit, publication-gap

status · enum<string>

Filter by opportunity status

Available options: New, In Progress, Done, Archived

difficulty · enum<string>

Filter by difficulty level

Available options: Easy, Medium, Hard

domain · string

Filter by domain (substring match)

archived · boolean

Include archived opportunities (default: false)

sort_by · enum<string> · default: priority_score

Sort opportunities by field

Available options: priority_score, fit_score, last_seen

limit · integer · default: 100

Number of items per page (1-500)

Required range: 1 <= x <= 500

cursor · string

Pagination cursor from previous response

Response

200

application/json

Successful response

brand_id · string · required

The brand ID

Example:

"1749113348709x432280934699237400"

opportunities · object[] · required

Array of outreach opportunity objects

Show child attributes

pagination · object · required

Show child attributes