{"id":21740875,"url":"https://github.com/whois-api-llc/python-bulk-email-verifier","last_synced_at":"2025-03-21T01:15:32.750Z","repository":{"id":57416648,"uuid":"449275143","full_name":"whois-api-llc/python-bulk-email-verifier","owner":"whois-api-llc","description":"Bulk Email Verification API client library for Python","archived":false,"fork":false,"pushed_at":"2023-05-23T03:13:44.000Z","size":14,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-28T17:45:55.916Z","etag":null,"topics":["api","bulk","bulk-api","email","email-verification","email-verifier","verification","whoisxmlapi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/whois-api-llc.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.rst","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-18T12:27:35.000Z","updated_at":"2025-02-18T17:44:04.000Z","dependencies_parsed_at":"2025-01-25T21:27:56.571Z","dependency_job_id":"e8cd27a2-2101-4365-aee2-061e9833292e","html_url":"https://github.com/whois-api-llc/python-bulk-email-verifier","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whois-api-llc%2Fpython-bulk-email-verifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whois-api-llc%2Fpython-bulk-email-verifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whois-api-llc%2Fpython-bulk-email-verifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whois-api-llc%2Fpython-bulk-email-verifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whois-api-llc","download_url":"https://codeload.github.com/whois-api-llc/python-bulk-email-verifier/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244717339,"owners_count":20498284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","bulk","bulk-api","email","email-verification","email-verifier","verification","whoisxmlapi"],"created_at":"2024-11-26T06:15:44.913Z","updated_at":"2025-03-21T01:15:32.729Z","avatar_url":"https://github.com/whois-api-llc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: https://img.shields.io/badge/License-MIT-green.svg\n    :alt: python-bulk-email-verifier license\n    :target: https://opensource.org/licenses/MIT\n\n.. image:: https://img.shields.io/pypi/v/bulk-email-verifier.svg\n    :alt: python-bulk-email-verifier release\n    :target: https://pypi.org/project/bulk-email-verifier\n\n.. image:: https://github.com/whois-api-llc/python-bulk-email-verifier/workflows/Build/badge.svg\n    :alt: python-bulk-email-verifier build\n    :target: https://github.com/whois-api-llc/python-bulk-email-verifier/actions\n\n========\nOverview\n========\n\nThe client library for\n`Bulk Email Verification API \u003chttps://emailverification.whoisxmlapi.com/bulk-api\u003e`_\nin Python language.\n\nThe minimum Python version is 3.6.\n\nInstallation\n============\n\n.. code-block:: shell\n\n    pip install bulk-email-verifier\n\nExamples\n========\n\nFull API documentation available `here \u003chttps://emailverification.whoisxmlapi.com/bulk-api/documentation/making-requests\u003e`_\n\nCreate a new client\n-------------------\n\n.. code-block:: python\n\n    from bulkemailverifier import *\n\n    client = Client('Your API key')\n\nCreate bulk request\n-------------------\n\n.. code-block:: python\n\n    emails = [\n        'example@example.com',\n        'test@example.org',\n        'test'\n    ]\n\n    request_id = client.create_request(emails=emails)\n\nGet request status\n-------------------\n\n.. code-block:: python\n\n    result = client.get_status(request_ids=[request_id])\n\n    # Finished once result.data[i].ready == True\n    print(result)\n\nGet email records\n-------------------\n\n.. code-block:: python\n\n    completed = client.get_records(request_id=request_id)\n\n    # Invalid and failed emails\n    failed = client.get_records(request_id=request_id, return_failed=True)\n\nList your requests\n-------------------\n\n.. code-block:: python\n\n    result = client.get_requests()\n\nDownload CSV result\n-------------------\n\n.. code-block:: python\n\n    client.download(filename='emails.csv', request_id=request_id)\n\nExtras\n-------------------\n\n.. code-block:: python\n\n    # Paginate over request IDs in descending order and get results in XML\n    result = client.get_requests_raw(\n        only_ids=True,\n        page=2,\n        per_page=20,\n        sort=Client.SORT_DESC,\n        output_format=Client.XML_FORMAT\n    )\n\nResponse model overview\n-----------------------\n\n.. code-block:: python\n\n    ResponseRecords:\n        - data: [Record]\n            - email_address: str\n            - format_check: bool\n            - smtp_check: bool\n            - dns_check: bool\n            - free_check: bool\n            - disposable_check: bool\n            - catch_all_check: bool\n            - result: str\n            - error: str\n            - mx_records: [str]\n\n    ResponseRequests:\n        - current_page: int\n        - from_requests: int\n        - last_page: int\n        - per_page: int\n        - to_requests: int\n        - total: int\n        - data: [BulkRequest]\n            - id: int\n            - date_start: datetime.datetime\n            - total_emails: int\n            - invalid_emails: int\n            - processed_emails: int\n            - failed_emails: int\n            - ready: bool\n\n    ResponseStatus:\n        - data: [BulkRequest]\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhois-api-llc%2Fpython-bulk-email-verifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhois-api-llc%2Fpython-bulk-email-verifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhois-api-llc%2Fpython-bulk-email-verifier/lists"}