Bidsandtenders APIopportunities.bidsandtenders.com ↗

"""Walkthrough: BidsAndTenders SDK — search open bids, drill into details and documents."""
from parse_apis.opportunities_bidsandtenders_com_api import (
    BidsAndTenders, BidStatus, SortField, SortDirection, InputNotFound,
)

client = BidsAndTenders()

# Browse open bids sorted by closing date, newest first.
for bid_summary in client.bid_summaries.search(
    status=BidStatus.OPEN,
    sort=SortField.CLOSING_DATE,
    direction=SortDirection.DESC,
    limit=5,
):
    print(bid_summary.name, bid_summary.status, bid_summary.organization)

# Drill into the first construction-keyword result for full details.
hit = client.bid_summaries.search(query="Construction", limit=1).first()
if hit is not None:
    bid = hit.details()
    print(bid.bid_name, bid.bid_number, bid.bid_classification)
    print("closing:", bid.closing_date)
    for doc in bid.documents:
        print(" doc:", doc.name, f"({doc.pages} pages)")
    for meeting in bid.meetings:
        print(" meeting:", meeting.location, meeting.start, meeting.mandatory)

    # Resolve the first document's downloadable file metadata.
    if bid.documents:
        bid_doc = bid.get_document(document_id=bid.documents[0].document_id)
        print(" download:", bid_doc.file_name, bid_doc.size_bytes, "bytes")
        print(" url:", bid_doc.download_url)

# Point-lookup by URL when the detail_url is already known.
if hit is not None:
    try:
        detail = client.bids.get(detail_url=hit.detail_url)
        print(detail.bid_name, detail.bid_status)
    except InputNotFound:
        print("bid no longer available")

# List buyer organizations and use one to narrow a search.
org = client.organizations.list(limit=1).first()
if org is not None:
    for bid_summary in client.bid_summaries.search(
        organization_id=org.organization_id,
        status=BidStatus.ALL,
        limit=3,
    ):
        print(org.name, "—", bid_summary.name)

print("exercised: bid_summaries.search / details / get_document / bids.get / organizations.list")