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-contact-data-apollo

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