Avvo APIavvo.com ↗

"""Walkthrough: Avvo Legal Directory — search attorneys, view profiles and reviews."""
from parse_apis.avvo_legal_directory_api import Avvo, AttorneyNotFound

client = Avvo()

# Search for criminal defense attorneys in California
for attorney in client.attorneysummaries.search(practice_area="criminal defense", state="ca", limit=3):
    print(attorney.name, attorney.avvo_rating, attorney.phone)

# Drill into the first result's full profile
summary = client.attorneysummaries.search(practice_area="family", state="tx", limit=1).first()
if summary:
    profile = summary.details()
    print(profile.name, profile.avvo_rating, profile.about[:80] if profile.about else "")
    print("Education:", profile.education)
    print("Practice areas:", profile.practice_areas)

    # Walk the attorney's client reviews via sub-resource
    for review in profile.reviews.list(limit=3):
        print(review.rating, review.header_info, review.text[:60] if review.text else "")

# Handle not-found errors when drilling into a summary
try:
    result = client.attorneysummaries.search(practice_area="bankruptcy", state="ny", limit=1).first()
    if result:
        detail = result.details()
        print(detail.name, detail.review_count)
except AttorneyNotFound as exc:
    print(f"Attorney not found: {exc.url}")

# Browse practice area categories
for group in client.practiceareagroups.list(limit=5):
    print(group.letter, [a.name for a in group.areas[:3]])

# Search legal Q&A
for question in client.legalquestions.search(query="divorce custody", limit=3):
    print(question.title, question.url)

print("exercised: attorneysummaries.search / details / reviews.list / practiceareagroups.list / legalquestions.search")