{"openapi":"3.1.0","info":{"title":"Apollo via Locus MPP","version":"1.0.0","description":"People and company enrichment, lead search, and sales intelligence with 275M+ contacts.","contact":{"email":"api@paywithlocus.com"},"x-guidance":"Use the documented POST operations for Apollo. Send JSON matching each requestBody schema. Unpaid public x402 requests return an x402 v2 payment challenge; retry the same body with PAYMENT-SIGNATURE and the returned x-locus-request-id."},"x-agentcash-guidance":{"llmsTxtUrl":"https://paywithlocus.com/mpp/apollo.md"},"x-service-info":{"categories":["data"],"docs":{"homepage":"https://www.apollo.io","apiReference":"https://docs.apollo.io","llms":"https://paywithlocus.com/mpp/apollo.md"}},"paths":{"/apollo/people-enrichment":{"post":{"operationId":"apollo_people_enrichment","summary":"People Enrichment","description":"Find and enrich a person by name, company, email, or LinkedIn URL, returning contact details such as personal emails and phone numbers when requested.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"intent":"charge","method":"tempo","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"$0.038-$0.318"},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"first_name":{"type":"string","description":"First name"},"last_name":{"type":"string","description":"Last name"},"email":{"type":"string","description":"Email address"},"linkedin_url":{"type":"string","description":"LinkedIn profile URL"},"organization_name":{"type":"string","description":"Current company name"},"domain":{"type":"string","description":"Current company domain"},"id":{"type":"string","description":"Apollo person ID"},"reveal_personal_emails":{"type":"boolean","description":"Include personal emails in results"},"reveal_phone_number":{"type":"boolean","description":"Include phone numbers (+$0.280)"}},"allOf":[{"description":"At least one identifier is required: email, linkedin_url, id, first_name+last_name, or organization_name/domain","anyOf":[{"required":["email"]},{"required":["linkedin_url"]},{"required":["id"]},{"required":["first_name","last_name"]},{"required":["organization_name"]},{"required":["domain"]}]}],"additionalProperties":true},"example":{"first_name":"Tim","last_name":"Cook","domain":"apple.com"}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt"},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/apollo/bulk-people-enrichment":{"post":{"operationId":"apollo_bulk_people_enrichment","summary":"Bulk People Enrichment","description":"Enrich up to 10 people in a single request.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"intent":"charge","method":"tempo","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"$0.038-$0.318/person"},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"details":{"description":"Array of person identifiers (max 10). Each object can have: first_name, last_name, email, linkedin_url, organization_name, domain","type":"array","items":{"type":"object","properties":{"first_name":{"type":"string"},"last_name":{"type":"string"},"email":{"type":"string"},"linkedin_url":{"type":"string"},"organization_name":{"type":"string"},"domain":{"type":"string"},"id":{"type":"string"}},"additionalProperties":true},"minItems":1,"maxItems":10},"reveal_phone_number":{"type":"boolean","description":"Include phone numbers for all (+$0.280/person)"},"reveal_personal_emails":{"type":"boolean","description":"Include personal emails for all"}},"required":["details"],"additionalProperties":true},"example":{"details":[{"first_name":"Tim","last_name":"Cook","domain":"apple.com"}],"reveal_phone_number":false,"reveal_personal_emails":false}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt"},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/apollo/org-enrichment":{"post":{"operationId":"apollo_org_enrichment","summary":"Organization Enrichment","description":"Get company data including industry, employee count, funding, revenue, and tech stack.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"intent":"charge","method":"tempo","amount":"38000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"$0.038"},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Company domain"},"linkedin_url":{"type":"string","description":"Company LinkedIn URL"},"website":{"type":"string","description":"Full company website URL"},"name":{"type":"string","description":"Company name to improve identifier match accuracy"}},"allOf":[{"description":"domain, linkedin_url, or website is required","anyOf":[{"required":["domain"]},{"required":["linkedin_url"]},{"required":["website"]}]}],"additionalProperties":true},"example":{"domain":"apple.com"}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt"},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/apollo/bulk-org-enrichment":{"post":{"operationId":"apollo_bulk_org_enrichment","summary":"Bulk Organization Enrichment","description":"Enrich up to 10 organizations by domain in a single request.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"intent":"charge","method":"tempo","amount":null,"currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"$0.038/org"},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"string"},"description":"Array of company domains (max 10), e.g. [\"anthropic.com\", \"openai.com\"]"}},"required":["domains"],"additionalProperties":true},"example":{"domains":["apple.com"]}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt"},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/apollo/people-search":{"post":{"operationId":"apollo_people_search","summary":"People Search","description":"Search for people by job title, location, company, seniority, and more. Returns profile data but not contact details (use enrichment for emails/phones).","tags":["Data Enrichment"],"security":[],"x-payment-info":{"intent":"charge","method":"tempo","amount":"5000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"$0.005"},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q_keywords":{"type":"string","description":"Keywords to search for"},"person_titles":{"type":"array","items":{"type":"string"},"description":"Job titles to filter by"},"person_locations":{"type":"array","items":{"type":"string"},"description":"Locations to filter by"},"q_organization_domains_list":{"type":"array","items":{"type":"string"},"description":"Company domains to filter by"},"organization_ids":{"type":"array","items":{"type":"string"},"description":"Apollo organization IDs to filter by"},"person_seniorities":{"type":"array","items":{"type":"string"},"description":"Seniority levels: founder, c_suite, partner, vp, head, director, manager, senior, entry, intern"},"per_page":{"type":"number","description":"Results per page (max 100, default 25)"},"page":{"type":"number","description":"Page number (max 500)"}},"allOf":[{"description":"At least one search criterion is required: q_keywords, person_titles, person_locations, q_organization_domains_list (alias q_organization_domains), organization_ids, or person_seniorities","anyOf":[{"required":["q_keywords"]},{"required":["person_titles"]},{"required":["person_locations"]},{"required":["q_organization_domains_list"]},{"required":["q_organization_domains"]},{"required":["organization_ids"]},{"required":["person_seniorities"]}]}],"additionalProperties":true},"example":{"q_organization_domains_list":["apple.com"],"per_page":1,"page":1}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt"},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/apollo/org-search":{"post":{"operationId":"apollo_org_search","summary":"Organization Search","description":"Search for companies by name, industry, location, size, revenue, and more.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"intent":"charge","method":"tempo","amount":"38000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"$0.038"},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q_organization_domains_list":{"type":"array","items":{"type":"string"},"description":"Company domains to filter by (max 1,000)"},"q_organization_name":{"type":"string","description":"Organization name to search"},"organization_ids":{"type":"array","items":{"type":"string"},"description":"Apollo organization IDs to filter by"},"organization_locations":{"type":"array","items":{"type":"string"},"description":"Locations to filter by"},"q_organization_keyword_tags":{"type":"array","items":{"type":"string"},"description":"Keyword tags to filter by"},"organization_num_employees_ranges":{"type":"array","items":{"type":"string"},"description":"Employee count ranges (e.g., \"1,10\", \"11,50\", \"51,200\")"},"per_page":{"type":"number","description":"Results per page (max 100, default 25)"},"page":{"type":"number","description":"Page number (max 500)"}},"allOf":[{"description":"At least one search criterion is required: q_organization_domains_list, q_organization_name, organization_ids, organization_locations, q_organization_keyword_tags, or organization_num_employees_ranges","anyOf":[{"required":["q_organization_domains_list"]},{"required":["q_organization_name"]},{"required":["organization_ids"]},{"required":["organization_locations"]},{"required":["q_organization_keyword_tags"]},{"required":["organization_num_employees_ranges"]}]}],"additionalProperties":true},"example":{"q_organization_name":"Apple","per_page":1,"page":1}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt"},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/apollo/job-postings":{"post":{"operationId":"apollo_job_postings","summary":"Organization Job Postings","description":"Get current job postings for a company — useful for identifying hiring signals.","tags":["Data Enrichment"],"security":[],"x-payment-info":{"intent":"charge","method":"tempo","amount":"38000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"$0.038"},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organization_id":{"type":"string","description":"Apollo organization ID"},"page":{"type":"number","description":"Positive page number"},"per_page":{"type":"number","description":"Results per page (max 10,000)"}},"required":["organization_id"],"additionalProperties":true},"example":{"organization_id":"<from apollo/org-enrichment>","page":1,"per_page":1}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt"},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/apollo/news-search":{"post":{"operationId":"apollo_news_search","summary":"News Articles Search","description":"Find recent news articles connected to organizations in Apollo's database. Requires organization IDs (get them from org-search or org-enrichment first).","tags":["Data Enrichment"],"security":[],"x-payment-info":{"intent":"charge","method":"tempo","amount":"38000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"$0.038"},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organization_ids":{"type":"array","items":{"type":"string"},"description":"Apollo organization IDs to find news for"},"categories":{"type":"array","items":{"type":"string"},"description":"News categories such as hires, investment, or contract"},"published_at_min":{"type":"string","description":"Earliest publication date (YYYY-MM-DD)"},"published_at_max":{"type":"string","description":"Latest publication date (YYYY-MM-DD)"},"per_page":{"type":"number","description":"Results per page (max 25)"},"page":{"type":"number","description":"Page number"}},"required":["organization_ids"],"additionalProperties":true},"example":{"organization_ids":["<from apollo/org-enrichment>"],"per_page":1,"page":1}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt"},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}}}}