Salesforce APItrailhead.salesforce.com ↗

"""Walkthrough: Salesforce Trailblazer Community — browse topics, search questions, enrich a company, find practitioners."""
from parse_apis.trailhead_salesforce_com_api import (
    Trailhead, FeedSort, AnswerStatus, InputNotFound,
)

client = Trailhead()

# Browse featured topic categories and pick the first topic from each.
for cat in client.topic_categories.list(limit=3):
    print(cat.category)
    for topic in cat.topics[:3]:
        print(f"  {topic.name} ({topic.id})")

# Search unanswered questions, newest first — cap at 5 total items.
for q in client.question_summaries.search(
    sort=FeedSort.CREATED_DATE,
    answer_status=AnswerStatus.UNANSWERED,
    limit=5,
):
    print(q.title, f"by {q.author.name} at {q.author.company}")

# Drill from a search hit into the full question with all answers.
hit = client.question_summaries.search(query="flow error", limit=1).first()
if hit is not None:
    detail = hit.details()
    print(detail.title, f"— {detail.answer_count} answers")
    for ans in detail.answers[:3]:
        print(f"  {ans.author.name}: {ans.body[:100]}")

# Point-lookup by an id discovered from the search above.
if hit is not None:
    try:
        question = client.questions.get(id=hit.id)
        print(question.title, question.posted_in.name)
    except InputNotFound:
        print("Question was deleted")

# Enrich a company to find community members and related posts.
report = client.enrichments.enrich(company="Cognizant", max_posts=10)
print(f"{report.company}: {report.people_count} people, {report.posts_count} posts")
for person in report.people[:3]:
    print(f"  {person.name} — {person.job_title} at {person.company}")
for post in report.posts[:3]:
    print(f"  {post.title}: {post.author.name}")

# Find practitioners who discuss specific tools, filtered to US-based admins.
practitioners = client.practitioners.find(
    terms="copado,gearset", country="United States", roles="Administrator",
)
print(f"{practitioners.people_count} practitioners across {practitioners.posts_count} posts")
for p in practitioners.people[:5]:
    print(f"  {p.name} ({p.role}) — {p.post_count} posts, matched: {', '.join(p.terms_matched)}")

print("exercised: topic_categories.list / question_summaries.search / details / questions.get / enrichments.enrich / practitioners.find")