Introduction

Python introduction:

Apollo API Reference

github.io

https://apolloio.github.io/apollo-api-docs/?python#introduction

import requests

url = "https://api.apollo.io/v1/auth/health"

querystring = {
    "api_key": "YOUR API KEY HERE"
}

headers = {
    'Cache-Control': 'no-cache',
    'Content-Type': 'application/json'
}

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)

Cannot get email from Linkedin profile though:

email-tools/apollo-people-enrichment-api.jpg

Dashboard

apollo/230413-0920-apollo-api-dashboard.jpg

Response

⚠️ WARNING: querying the same parameters multiple times will result in using a credit each time, despite same response.

Sample response:

{
    "person": {
        "id": "583f2f7ed9ced98ab5bfXXXX",
        "first_name": "Tim",
        "last_name": "Zheng",
        "name": "Tim Zheng",
        "linkedin_url": "http://www.linkedin.com/in/tim-zheng-677ba010",
        "title": "Founder & CEO",
        "city": "San Francisco",
        "email_status": null,
        "photo_url": "https://media-server.url",
        "twitter_url": null,
        "github_url": null,
        "facebook_url": null,
        "extrapolated_email_confidence": null,
        "headline": "Founder & CEO at Apollo",
        "country": "United States",
        "email": "name@domain.io",
        "state": "CA",
        "excluded_for_leadgen": false,
        "contact_id": "5da8ceXXXXXXXXXXXXXXXX",
        "contact": {
            "id": "5da8ceXXXXXXXXXXXXXXXX",
            "first_name": "Tim",
            "last_name": "Zheng",
            "name": "Tim Zheng",
            "linkedin_url": "http://www.linkedin.com/in/tim-zheng-677ba010",
            "title": "Founder & CEO",
            "contact_stage_id": "5c48fb36ae29ba0f376d11ab",
            "owner_id": "5c1004XXXXXXXXXXXXXXXXXX",
            "person_id": "5eb53cXXXXXXXXXXXXXXXX",
            "email_needs_tickling": false,
            "organization_name": "Apollo",
            "source": "search",
            "original_source": "email_import",
            "organization_id": "5e66b6XXXXXXXXXXXXXXXX",
            "headline": "Founder & CEO at Apollo",
            "photo_url": "https://static-exp2.licdn.com/sc/h/djzv59yelk5urv2ujlazfyvrk",
            "present_raw_address": "San Francisco, California, United States",
            "linkedin_uid": "38777275",
            "extrapolated_email_confidence": 0,
            "salesforce_id": "0031UXXXXXXXXXXXX",
            "salesforce_lead_id": null,
            "salesforce_contact_id": "0031UXXXXXXXXXXXX",
            "salesforce_account_id": "0011UXXXXXXXXXXXX",
            "salesforce_owner_id": "0051UXXXXXXXXXXXX",
            "created_at": "2019-10-17T20:25:07.594Z",
            "lead_request_id": null,
            "test_predictive_score": null,
            "emailer_campaign_ids": [],
            "email_manually_changed": false,
            "direct_dial_status": null,
            "direct_dial_enrichment_failed_at": null,
            "email_status": "verified",
            "account_id": "5f1faXXXXXXXXXXXXXXXX",
            "last_activity_date": "2018-06-26T16:30:35.000+00:00",
            "hubspot_vid": null,
            "hubspot_company_id": null,
            "sanitized_phone": null,
            "merged_crm_ids": [],
            "typed_custom_fields": {
                "5d856e9c6899d00098XXXXXX": "Tim Zheng"
            },
            "updated_at": "2020-07-28T04:44:51.448Z",
            "queued_for_crm_push": false,
            "starred_by_user_ids": [],
            "suggested_from_rule_engine_config_id": null,
            "label_ids": [],
            "has_pending_email_arcgate_request": false,
            "has_email_arcgate_request": false,
            "existence_level": "full",
            "email": "example@domain.com",
            "salesforce_record_url": "https://na85.salesforce.com/0031UXXXXXXXXXXXX",
            "phone_numbers": [],
            "account_phone_note": null
        },
        "revealed_for_current_team": true,
        "organization_id": "5e66b6XXXXXXXXXXXXXXXX",
        "organization": {
            "id": "5e66b6XXXXXXXXXXXXXXXX",
            "name": "Apollo",
            "website_url": "http://www.apollo.io",
            "blog_url": null,
            "angellist_url": null,
            "linkedin_url": "http://www.linkedin.com/company/apolloio",
            "twitter_url": "https://twitter.com/MeetApollo/",
            "facebook_url": "https://www.facebook.com/MeetApollo/",
            "languages": [],
            "alexa_ranking": 1955,
            "phone": null,
            "linkedin_uid": "18511550",
            "publicly_traded_symbol": null,
            "publicly_traded_exchange": null,
            "logo_url": "https://apollo-server.com/uploads/pictures/5f026XXXXXXXXXXXXXXXX/picture",
            "crunchbase_url": null,
            "primary_domain": "apollo.io",
            "persona_counts": {},
            "industry": "computer software",
            "keywords": [
                "sales engagement",
                "lead generation",
                "predictive analytics",
                "lead scoring",
                "sales strategy",
                "conversation intelligence",
                "sales enablement",
                "lead routing",
                "sales development",
                "and email engagement"
            ],
            "estimated_num_employees": 38,
            "snippets_loaded": true,
            "industry_tag_id": "5567cdXXXXXXXXXXXXXXXX",
            "retail_location_count": 0,
            "raw_address": "535 Mission St, Suite 1100, San Francisco, California 94105, US",
            "street_address": "535 Mission St",
            "city": "San Francisco",
            "state": "California",
            "postal_code": "94105",
            "country": "United States",
            "owned_by_organization_id": null,
            "suborganizations": [],
            "num_suborganizations": 0,
            "seo_description": "Apollo is an intelligent, data-first engagement platform that puts structured data at the core of your workflows to help you execute, analyze, and improve on your growth strategy.",
            "short_description": "Apollo is the unified engagement acceleration platform that gives reps the ability to dramatically increase their number of quality conversations and opportunities. Reps are ...",
            "total_funding": null,
            "total_funding_printed": null,
            "latest_funding_round_date": null,
            "latest_funding_stage": null,
            "funding_events": [],
            "technology_names": [
                "Cloudflare DNS",
                "Rackspace MailGun",
                "Gmail",
                "Marketo",
                "Google Apps",
                "Microsoft Office 365",
                "CloudFlare Hosting",
                ...
            ],
            "current_technologies": [
                {
                    "uid": "cloudflare_dns",
                    "name": "Cloudflare DNS",
                    "category": "Domain Name Services"
                },
                {
                    "uid": "rackspace_mailgun",
                    "name": "Rackspace MailGun",
                    "category": "Email Delivery"
                },
                {
                    "uid": "gmail",
                    "name": "Gmail",
                    "category": "Email Providers"
                },
                {
                    "uid": "marketo",
                    "name": "Marketo",
                    "category": "Marketing Automation"
                },
                {
                    "uid": "google_apps",
                    "name": "Google Apps",
                    "category": "Other"
                },
                {
                    "uid": "office_365",
                    "name": "Microsoft Office 365",
                    "category": "Other"
                },
                {
                    "uid": "cloudflare_hosting",
                    "name": "CloudFlare Hosting",
                    "category": "Hosting"
                },
                {
                   ...
                }
            ]
        },
        "personal_emails": [
            "personalemail1@domain.com",
            "personalemail2@domain.com"
        ],
       "departments": [
           "c_suite",
           "master_information_technology",
           "master_operations"
       ],
       "subdepartments": [
           "operations_executive",
           "business_service_management_itsm",
           "operations"
       ],
       "functions": [
           "operations"
       ],
       "seniority": "c_suite"
    }
}

.text output is messy:

type(response)=<class 'requests.models.Response'>

response.text:

('{"person":{"id":"54ebd77b7468694311fb3631","first_name":"Makenzie","last_name":"Peecook","name":"Makenzie '
 'Peecook","linkedin_url":"http://www.linkedin.com/in/makenzie-peecook","title":"Event '
 'Manager, Conference and Event '
 'Services","email_status":"verified","photo_url":"https://media.licdn.com/dms/image/C5603AQF7EFX4tMwwUg/profile-displayphoto-shrink_800_800/0/1654183473987?e=2147483647\\u0026v=beta\\u0026t=VOWsDULYua7CrZH6-K2EcYqqtBhb0QPEVPYDa7L9lrw","twitter_url":null,"github_url":null,"facebook_url":null,"extrapolated_email_confidence":null,"headline":"Event '
 'Manager, Conference and Event '
 'Services","email":"makpeeco@umich.edu","organization_id":"5a9f77bba6da98d9a15f5ae8","employment_history":[{"_id":"639ebe806671c3000123e9c8","created_at":"2022-12-18T07:17:20.246Z","current":true,"degree":null,"description":null,"emails":null,"end_date":null,"grade_level":null,"kind":null,"major":null,"organization_id":"5a9f77bba6da98d9a15f5ae8","organization_name":"University '
 'of Michigan","raw_address":null,"start_date":"2022-05-01","title":"Event '
 'Manager, Conference and Event '
 'Services","updated_at":"2022-12-18T07:17:20.246Z","id":"639ebe806671c3000123e9c8","key":"639ebe806671c3000123e9c8"},{"_id":"64175612d8cffd000150a350","created_at":"2023-03-19T18:36:02.699Z","current":false,"degree":null,"description":null,"emails":null,"end_date":"2021-10-01","grade_level":null,"kind":null,"major":null,"organization_id":"637f2db4ac5577000126b242","organization_name":"Art '
 'House '
 'Convergence","raw_address":null,"start_date":"2017-08-01","title":"Events '
 'and Operations '
 'Manager","updated_at":"2023-03-19T18:36:02.699Z","id":"64175612d8cffd000150a350","key":"64175612d8cffd000150a350"},{"_id":"64175612d8cffd000150a351","created_at":"2023-03-19T18:36:02.699Z","current":false,"degree":null,"description":null,"emails":null,"end_date":"2020-05-01","grade_level":null,"kind":null,"major":null,"organization_id":"604a57316090c30001961581","organization_name":"Michigan '
 'Theater","raw_address":null,"start_date":"2016-08-01","title":"Board of '
 'Directors '
 'Administrator","updated_at":"2023-03-19T18:36:02.699Z","id":"64175612d8cffd000150a351","key":"64175612d8cffd000150a351"},{"_id":"64175612d8cffd000150a352","created_at":"2023-03-19T18:36:02.699Z","current":false,"degree":null,"description":null,"emails":null,"end_date":"2017-08-01","grade_level":null,"kind":null,"major":null,"organization_id":"637f2db4ac5577000126b242","organization_name":"Art '
 'House '
 'Convergence","raw_address":null,"start_date":"2016-07-01","title":"Project '
 'Coordinator","updated_at":"2023-03-19T18:36:02.699Z","id":"64175612d8cffd000150a352","key":"64175612d8cffd000150a352"},{"_id":"64175612d8cffd000150a353","created_at":"2023-03-19T18:36:02.699Z","current":false,"degree":null,"description":null,"emails":null,"end_date":"2019-05-01","grade_level":null,"kind":null,"major":null,"organization_id":"5569cbd873696425295c9700","organization_name":"Cinetopia '
 'International Film '
 'Festival","raw_address":null,"start_date":"2015-02-01","title":"Film '
 'Programmer; Volunteer \\u0026 Internship Manager; Operations '
 'Coordinator","updated_at":"2023-03-19T18:36:02.699Z","id":"64175612d8cffd000150a353","key":"64175612d8cffd000150a353"},{"_id":"64175612d8cffd000150a354","created_at":"2023-03-19T18:36:02.699Z","current":false,"degree":null,"description":null,"emails":null,"end_date":"2015-05-01","grade_level":null,"kind":null,"major":null,"organization_id":null,"organization_name":"Music '
 'Con","raw_address":null,"start_date":"2014-09-01","title":"Chair, '
 'Co-Founder","updated_at":"2023-03-19T18:36:02.699Z","id":"64175612d8cffd000150a354","key":"64175612d8cffd000150a354"},{"_id":"64175612d8cffd000150a355","created_at":"2023-03-19T18:36:02.699Z","current":false,"degree":null,"description":null,"emails":null,"end_date":"2014-08-01","grade_level":null,"kind":null,"major":null,"organization_id":"5569799f73696425214a3a00","organization_name":"Superfly","raw_address":null,"start_date":"2014-06-01","title":"Booking/Programming '
 'Intern","updated_at":"2023-03-19T18:36:02.699Z","id":"64175612d8cffd000150a355","key":"64175612d8cffd000150a355"},{"_id":"64175612d8cffd000150a356","created_at":"2023-03-19T18:36:02.700Z","current":false,"degree":null,"description":null,"emails":null,"end_date":"2016-07-01","grade_level":null,"kind":null,"major":null,"organization_id":"604a57316090c30001961581","organization_name":"Michigan '
 'Theater","raw_address":null,"start_date":"2013-12-01","title":"Front of '
 'House '
 'Manager","updated_at":"2023-03-19T18:36:02.700Z","id":"64175612d8cffd000150a356","key":"64175612d8cffd000150a356"},{"_id":"64175612d8cffd000150a357","created_at":"2023-03-19T18:36:02.700Z","current":false,"degree":null,"description":null,"emails":null,"end_date":"2014-05-01","grade_level":null,"kind":null,"major":null,"organization_id":null,"organization_name":"New '
 'Beat Happening (Campus '
 'Dept.)","raw_address":null,"start_date":"2013-09-01","title":"President","updated_at":"2023-03-19T18:36:02.700Z","id":"64175612d8cffd000150a357","key":"64175612d8cffd000150a357"},{"_id":"64175612d8cffd000150a358","created_at":"2023-03-19T18:36:02.700Z","current":false,"degree":null,"description":null,"emails":null,"end_date":"2013-05-01","grade_level":null,"kind":null,"major":null,"organization_id":null,"organization_name":"New '
 'Beat Happening (Campus '
 'Dept.)","raw_address":null,"start_date":"2012-09-01","title":"Ground '
 'Marketing '
 'Director","updated_at":"2023-03-19T18:36:02.700Z","id":"64175612d8cffd000150a358","key":"64175612d8cffd000150a358"}],"state":"Michigan","city":"Ann '
 'Arbor","country":"United '
 'States","contact_id":"64266f899a421a00a33f88a4","contact":{"id":"64266f899a421a00a33f88a4","first_name":"Makenzie","last_name":"Peecook","name":"Makenzie '
 'Peecook","linkedin_url":"http://www.linkedin.com/in/makenzie-peecook","title":"Event '
 'Manager, Conference and Event '
 'Services","contact_stage_id":"6426675a43030601320ded0c","owner_id":"6426675b43030601320ded86","creator_id":"6426675b43030601320ded86","person_id":"54ebd77b7468694311fb3631","email_needs_tickling":false,"organization_name":"University '
 'of '
 'Michigan","source":"search","original_source":"search","organization_id":"5a9f77bba6da98d9a15f5ae8","headline":"Event '
 'Manager, Conference and Event '
 'Services","photo_url":"https://media.licdn.com/dms/image/C5603AQF7EFX4tMwwUg/profile-displayphoto-shrink_800_800/0/1654183473987?e=2147483647\\u0026v=beta\\u0026t=VOWsDULYua7CrZH6-K2EcYqqtBhb0QPEVPYDa7L9lrw","present_raw_address":"Ann '
 'Arbor, Michigan, United '
 'States","linkedin_uid":null,"extrapolated_email_confidence":null,"salesforce_id":null,"salesforce_lead_id":null,"salesforce_contact_id":null,"salesforce_account_id":null,"crm_owner_id":null,"created_at":"2023-03-31T05:28:41.202Z","emailer_campaign_ids":[],"direct_dial_status":null,"direct_dial_enrichment_failed_at":null,"email_status":"verified","email_source":"gmail_directory","account_id":"64266f899a421a00a33f88a6","last_activity_date":null,"hubspot_vid":null,"hubspot_company_id":null,"crm_id":null,"sanitized_phone":"+17347641817","merged_crm_ids":null,"updated_at":"2023-03-31T05:28:41.431Z","queued_for_crm_push":null,"suggested_from_rule_engine_config_id":null,"email_unsubscribed":null,"label_ids":[],"has_pending_email_arcgate_request":false,"has_email_arcgate_request":false,"existence_level":"full","email":"makpeeco@umich.edu","email_from_customer":null,"typed_custom_fields":{},"email_true_status":"Verified","updated_email_true_status":false,"contact_emails":[],"phone_numbers":[{"raw_number":"+1 '
 '(734) '
 '764-1817","sanitized_number":"+17347641817","type":"work_hq","position":0,"status":"no_status","dnc_status":null,"dnc_other_info":null}],"account_phone_note":null,"free_domain":false},"revealed_for_current_team":true,"organization":{"id":"5a9f77bba6da98d9a15f5ae8","name":"University '
 'of '
 'Michigan","website_url":"http://www.umich.edu","blog_url":null,"angellist_url":null,"linkedin_url":"http://www.linkedin.com/company/university-of-michigan","twitter_url":"https://twitter.com/umich","facebook_url":"https://facebook.com/UniversityOfMichigan/","primary_phone":{"number":"+1 '
 '(734) '
 '764-1817","source":"Account"},"languages":["English","Spanish"],"alexa_ranking":1449,"phone":"+1 '
 '(734) '
 '764-1817","linkedin_uid":"2516","founded_year":1817,"publicly_traded_symbol":null,"publicly_traded_exchange":null,"logo_url":"https://zenprospect-production.s3.amazonaws.com/uploads/pictures/63bea5e050adc90001a81f15/picture","crunchbase_url":null,"primary_domain":"umich.edu","sanitized_phone":"+17347641817","persona_counts":{},"industry":"higher '
 'education","keywords":["education","human resources benefits retirement '
 'savings '
 'plans"],"estimated_num_employees":34000,"snippets_loaded":true,"industry_tag_id":"5567cd4c73696453e1300000","retail_location_count":0,"raw_address":"503 '
 'Thompson Street, Ann Arbor, mi 48109, US","street_address":"503 Thompson '
 'St","city":"Ann '
 'Arbor","state":"Michigan","postal_code":"48109","country":"United '
 'States","owned_by_organization_id":null,"suborganizations":[],"num_suborganizations":0,"seo_description":"","short_description":"The '
 'mission of the University of Michigan is to serve the people of Michigan and '
 'the world through preeminence in creating, communicating, preserving and '
 'applying knowledge, art, and academic values, and in developing leaders and '
 'citizens who will challenge the present and enrich the '
 'future.","annual_revenue_printed":"8.4B","annual_revenue":8404323000.0,"total_funding":1700000,"total_funding_printed":"1.7M","latest_funding_round_date":"2021-10-01T00:00:00.000+00:00","latest_funding_stage":"Other","funding_events":[{"id":"6393f95bec298e00010d58e1","date":"2021-10-01T00:00:00.000+00:00","news_url":null,"type":"Other","investors":"National '
 'Institutes of '
 'Health","amount":"1.7M","currency":"$"}],"technology_names":["ASP.NET","AddThis","Adobe '
 'TestAndTarget","Apache","Bootstrap Framework","Canvas by '
 'Instructure","Cloudinary","CrazyEgg","Django","Drupal","Eventbrite","F5 '
 'BIG-IP","Facebook Custom Audiences","Facebook Login (Connect)","Facebook '
 'Widget","Formstack","Google Analytics","Google Font API","Google '
 'Maps","Google Maps (Non Paid Users)","Google Tag Manager","Gravity '
 'Forms","MailChimp","Microsoft Office 365","Microsoft-IIS","Mobile '
 'Friendly","New Relic","Nginx","OpenSSL","PHP '
 '5.3","Pingdom","Shutterstock","SoundCloud","Squarespace '
 'ECommerce","Typekit","Ubuntu","Varnish","Vimeo","WordPress.org","YouTube","reCAPTCHA"],"current_technologies":[{"uid":"asp_net","name":"ASP.NET","category":"Frameworks '
 'and Programming '
 'Languages"},{"uid":"addthis","name":"AddThis","category":"Social '
 'Sharing"},{"uid":"adobe_testandtarget","name":"Adobe '
 'TestAndTarget","category":"Online Testing '
 'Platforms"},{"uid":"apache","name":"Apache","category":"Load '
 'Balancers"},{"uid":"bootstrap_framework","name":"Bootstrap '
 'Framework","category":"CSS and JavaScript '
 'Libraries"},{"uid":"canvas_by_instructure","name":"Canvas by '
 'Instructure","category":"Education Management '
 'Software"},{"uid":"cloudinary","name":"Cloudinary","category":"Cloud '
 'Services"},{"uid":"crazyegg","name":"CrazyEgg","category":"Analytics and '
 'Tracking"},{"uid":"django","name":"Django","category":"Frameworks and '
 'Programming '
 'Languages"},{"uid":"drupal","name":"Drupal","category":"CMS"},{"uid":"eventbrite","name":"Eventbrite","category":"Event '
 'Management"},{"uid":"f5_big-ip","name":"F5 BIG-IP","category":"Load '
 'Balancers"},{"uid":"facebook_web_custom_audiences","name":"Facebook Custom '
 'Audiences","category":"Retargeting"},{"uid":"facebook_login","name":"Facebook '
 'Login (Connect)","category":"Social '
 'Login"},{"uid":"facebook_widget","name":"Facebook '
 'Widget","category":"Widgets"},{"uid":"formstack","name":"Formstack","category":"Hosted '
 'Forms"},{"uid":"google_analytics","name":"Google '
 'Analytics","category":"Analytics and '
 'Tracking"},{"uid":"google_font_api","name":"Google Font '
 'API","category":"Fonts"},{"uid":"google_maps","name":"Google '
 'Maps","category":"Other"},{"uid":"google_maps_non_paid_users","name":"Google '
 'Maps (Non Paid '
 'Users)","category":"Other"},{"uid":"google_tag_manager","name":"Google Tag '
 'Manager","category":"Tag Management"},{"uid":"gravity_forms","name":"Gravity '
 'Forms","category":"Hosted '
 'Forms"},{"uid":"mailchimp","name":"MailChimp","category":"Email '
 'Marketing"},{"uid":"office_365","name":"Microsoft Office '
 '365","category":"Other"},{"uid":"microsoft-iis","name":"Microsoft-IIS","category":"Load '
 'Balancers"},{"uid":"mobile_friendly","name":"Mobile '
 'Friendly","category":"Other"},{"uid":"new_relic","name":"New '
 'Relic","category":"Web Performance '
 'Monitoring"},{"uid":"nginx","name":"Nginx","category":"Load '
 'Balancers"},{"uid":"openssl","name":"OpenSSL","category":"SSL '
 'Certificates"},{"uid":"php_5_3","name":"PHP 5.3","category":"Frameworks and '
 'Programming Languages"},{"uid":"pingdom","name":"Pingdom","category":"Web '
 'Performance '
 'Monitoring"},{"uid":"shutterstock","name":"Shutterstock","category":"Other"},{"uid":"soundcloud","name":"SoundCloud","category":"Other"},{"uid":"squarespace_ecommerce","name":"Squarespace '
 'ECommerce","category":"E-commerce '
 'Platforms"},{"uid":"typekit","name":"Typekit","category":"Fonts"},{"uid":"ubuntu","name":"Ubuntu","category":"Load '
 'Balancers"},{"uid":"varnish","name":"Varnish","category":"Load '
 'Balancers"},{"uid":"vimeo","name":"Vimeo","category":"Online Video '
 'Platforms"},{"uid":"wordpress_org","name":"WordPress.org","category":"CMS"},{"uid":"youtube","name":"YouTube","category":"Online '
 'Video '
 'Platforms"},{"uid":"recaptcha","name":"reCAPTCHA","category":"Captcha"}]},"phone_numbers":[{"raw_number":"+1 '
 '(734) '
 '764-1817","sanitized_number":"+17347641817","type":"work_hq","position":0,"status":"no_status","dnc_status":null,"dnc_other_info":null}],"intent_strength":null,"show_intent":false,"departments":["master_marketing"],"subdepartments":["event_marketing","field_marketing"],"functions":[],"seniority":"manager"}}')

Working script

13 Apr 2023

See this note for my Python script that works using Apollo's API:

Python script: how to get contact data via API from Apollo.io

Learnings

When connecting Hubspot to Apollo, the API returns the Hubspot object of an organisation as account and the details of that organisation from Apollo under organization, eg:

organization
{   'alexa_ranking': 2020,
    'angellist_url': None,
    'blog_url': None,
    'crunchbase_url': None,
    'facebook_url': 'https://www.facebook.com/UCCRN',
    'founded_year': 1754,
    'id': '6400651509a89000018c6ce2',
    'languages': [],
    'linkedin_uid': '2624',
    'linkedin_url': 'http://www.linkedin.com/company/columbia-university',
    'logo_url': 'https://zenprospect-production.s3.amazonaws.com/uploads/pictures/63e23ba4835f7d0001520563/picture',
    'name': 'Columbia University',
    'persona_counts': {},
    'phone': '+1212-854-4900',
    'primary_domain': 'columbia.edu',
    'primary_phone': {   'country_code_added_from_hq': True,
                         'number': '+1212-854-4900',
                         'source': 'Owler'},
    'publicly_traded_exchange': None,
    'publicly_traded_symbol': None,
    'sanitized_phone': '+12128544900',
    'twitter_url': 'https://twitter.com/UCCRN',
    'website_url': 'http://www.columbia.edu'}



account
{   'account_playbook_statuses': [],
    'account_stage_id': '6435a7afc37f1a00da7470fc',
    'alexa_ranking': 2020,
    'angellist_url': None,
    'blog_url': None,
    'created_at': '2023-04-12T06:28:06.263Z',
    'crm_owner_id': '360460600',
    'crunchbase_url': None,
    'domain': 'columbia.edu',
    'existence_level': 'full',
    'facebook_url': 'https://www.facebook.com/UCCRN',
    'founded_year': 1754,
    'hubspot_id': '15251006492',
    'hubspot_record_url': 'https://app.hubspot.com/sales/24308136/company/15251006492',
    'id': '64364f763692e50001c461d4',
    'label_ids': [],
    'languages': [],
    'linkedin_uid': '2624',
    'linkedin_url': 'http://www.linkedin.com/company/columbia-university',
    'logo_url': 'https://zenprospect-production.s3.amazonaws.com/uploads/pictures/63e23ba4835f7d0001520563/picture',
    'modality': 'account',
    'name': 'Columbia University',
    'organization_id': '6400651509a89000018c6ce2',
    'original_source': 'crm',
    'owner_id': '6435a7b0c37f1a00da747176',
    'parent_account_id': None,
    'persona_counts': {},
    'phone': '2123263363',
    'phone_status': 'no_status',
    'primary_domain': 'columbia.edu',
    'primary_phone': {   'country_code_added_from_hq': True,
                         'number': '+1212-854-4900',
                         'source': 'Owler'},
    'publicly_traded_exchange': None,
    'publicly_traded_symbol': None,
    'salesforce_id': None,
    'sanitized_phone': '+12123263363',
    'source': 'crm',
    'team_id': '6435a7afc37f1a00da7470f1',
    'twitter_url': 'https://twitter.com/UCCRN',
    'typed_custom_fields': {},
    'website_url': 'http://www.columbia.edu'}

Endpoints

/search

url = "https://api.apollo.io/v1/mixed_people/search"

data = {
    "api_key": APOLLO_API_KEY,
    "q_organization_domains": "columbia.edu",
    "page" : 1,
    "person_titles" : ["event"]
}

headers = {
    'Cache-Control': 'no-cache',
    'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, json=data)

print(f"""\nℹ️  Apollo Response headers: Minute: {response.headers.get('x-minute-usage')}/{response.headers.get('x-minute-requests-left')} | Hourly: {response.headers.get('x-hourly-requests-left')}/{response.headers.get('x-rate-limit-hourly')} | Daily: {response.headers.get('x-24-hour-requests-left')}/{response.headers.get('x-24-hour-usage')}""")

response_data = response.json()

# Keys returned by the API:
# breadcrumbs = <class 'list'>
# partial_results_only = <class 'bool'>
# disable_eu_prospecting = <class 'bool'>
# partial_results_limit = <class 'int'>
# pagination = <class 'dict'>
# contacts = <class 'list'>
# people = <class 'list'>
# model_ids = <class 'list'>
# num_fetch_result = <class 'NoneType'>

print(f"\ntype(response_data) = {type(response_data)}\n")
for k,v in response_data.items():
    print(f"{k} = {type(v)}")


people = response_data.get('people', [])

for p in people:

    print(f"\n========== NEW PERSON ==========")

    # Keys returned by the API:
    # id = <class 'str'>
    # first_name = <class 'str'>
    # last_name = <class 'str'>
    # name = <class 'str'>
    # linkedin_url = <class 'str'>
    # title = <class 'str'>
    # email_status = <class 'str'>
    # photo_url = <class 'str'>
    # twitter_url = <class 'NoneType'>
    # github_url = <class 'NoneType'>
    # facebook_url = <class 'NoneType'>
    # extrapolated_email_confidence = <class 'NoneType'>
    # headline = <class 'str'>
    # email = <class 'str'>
    # organization_id = <class 'str'>
    # employment_history = <class 'list'>
    # state = <class 'str'>
    # city = <class 'str'>
    # country = <class 'str'>
    # organization = <class 'dict'>
    # account_id = <class 'str'>
    # account = <class 'dict'>
    # phone_numbers = <class 'list'>
    # intent_strength = <class 'NoneType'>
    # show_intent = <class 'bool'>
    # revealed_for_current_team = <class 'bool'>
    # departments = <class 'list'>
    # subdepartments = <class 'list'>
    # functions = <class 'list'>
    # seniority = <class 'str'>

Limits

API rate limits are per minute, hour and day. It's a rolling 24h window, ie doesn't reset at midnight 😅

Makes it hard to know when API limit will reset.

apollo/apollo-rate-limits.jpg