# QannasAPI One API key for B2B data. Unified person, company, contact, website, ads, maps, and social data behind a single credit-based API. Mirrored from https://api.qannasapi.com/llms.txt — the canonical copy served by the API itself. ## Base URL https://api.qannasapi.com ## Authentication Authorization: Bearer qk_live_... or qk_test_... Test-key calls are free and subject to the workspace daily quota. ## Credit Headers Every data response includes: - X-Credits-Charged: credits deducted (0 for no-result) - X-Credits-Balance: remaining balance - X-Price-Book: which price book was used ## No Result, No Charge If no result is returned: HTTP 200, data: null, X-Credits-Charged: 0 ## Data Endpoints ### Profiles - /v1/data/people/enrich - /v1/data/companies/enrich ### Search - /v1/data/search/people - /v1/data/search/companies - /v1/data/search/leads - /v1/data/search/lookalikes - /v1/data/search/jobs ### Contacts - /v1/data/contacts/find-email - /v1/data/contacts/verify-email - /v1/data/contacts/find-phone - /v1/data/contacts/reverse-lookup ### Website - /v1/data/websites/contacts - /v1/data/websites/intelligence - /v1/data/websites/tech-stack - /v1/data/websites/traffic - /v1/data/websites/resolve ### Maps - /v1/data/maps/places - /v1/data/maps/reviews ### Ads - /v1/data/ads/search - /v1/data/ads/details ### SEO - /v1/data/seo/serp - /v1/data/seo/keywords ### Funding - /v1/data/companies/funding ### AI - /v1/data/ai/enrich ### Jobs - POST /v1/jobs - GET /v1/jobs/{id} ### Billing - GET /v1/billing/usage - GET /v1/billing/packs - POST /v1/billing/packs/{pack_id}/purchase ### Estimate - POST /v1/data/{action}:estimate ## MCP Tools (34) - qannas_enrich_person: Enrich a person profile from name, LinkedIn URL, or email - qannas_enrich_company: Enrich a company profile from name or domain - qannas_bulk_enrich: Bulk enrich up to 50 people or companies - qannas_find_email: Find a person's email address - qannas_verify_email: Verify an email address is valid and deliverable - qannas_find_phone: Find a person's phone number - qannas_reverse_lookup: Reverse lookup a person from email or phone - qannas_search_people: Search for people by criteria - qannas_search_companies: Search for companies by criteria - qannas_search_leads: Advanced lead search with 30+ filters via `filters` — seniority[], functions[], industries[], company_size[], locations[]/geo_ids[], years_of_experience[], current_companies[], current_job_titles[], profile_languages[], schools[], recently_changed_jobs, plus exclude_* mirrors, or a full filters.sales_nav_url passthrough. `query` is a fuzzy keyword search. - qannas_lookalikes: Find lookalike companies similar to a seed domain - qannas_competitor_followers: Get followers of a competitor's social account - qannas_website_contacts: Extract contact info (emails, phones, social links) from a website - qannas_website_intelligence: Get full website intelligence (tech, SEO, traffic, contacts) - qannas_tech_stack: Get the technology stack of a website - qannas_web_traffic: Get website traffic data for a domain - qannas_maps_places: Search Google Maps for places - qannas_maps_reviews: Get reviews for a Google Maps place - qannas_ads_search: Search ad libraries (Meta, LinkedIn, Google transparency) - qannas_snapchat_ads_search: Search Snapchat's Ads Gallery for one exact advertiser (EU-27 + TR coverage only) - qannas_snapchat_ads_details: Get one Snapchat ad by UUID or ads_library URL - qannas_snapchat_sponsored_content: Snapchat sponsored content: one exact creator, or the live global feed when omitted - qannas_posts_search: Search social media posts across platforms - qannas_company_posts: Get recent posts from a company's social accounts - qannas_funding: Get funding history for a company - qannas_serp: Get search engine results page (SERP) for a query - qannas_ai_enrich: AI-powered enrichment of a person or company - qannas_usage: Get current credit balance and usage summary - qannas_workflow_lead_list: Build a verified lead list: search people, find each person's email, optionally verify every email. Success-only billing per step. - qannas_workflow_account_brief: Sales dossier for one account: company enrichment, tech stack, funding, recent posts, ads, and funding-event signals. - qannas_workflow_competitor_watch: Competitor snapshot: followers, recent posts, active ads, and web traffic (when the query is a domain). - qannas_workflow_market_map: Sample companies per (industry, country) cell. Reports sample sizes only — the service does not expose totals. - qannas_workflow_personalize: Personalization pack for one person: enrichment, recent activity, personality, and deterministic outreach angles (template logic, no LLM call). - qannas_workflow_clean_list: Verify a list of email addresses; bucket into valid/invalid/risky with a decay rate. Optionally reverse-lookup invalid ones. ## Credit Packs - Starter: 500 credits for $10.0 ($0.0200/credit) - Growth: 3000 credits for $50.0 ($0.0167/credit) - Scale: 10000 credits for $150.0 ($0.0150/credit) - Enterprise: 50000 credits for $600.0 ($0.0120/credit) ## Subscription Plans - Starter Monthly: 500 credits/month for $10.0/mo (rollover cap: 1000) - Growth Monthly: 3000 credits/month for $45.0/mo (rollover cap: 6000) - Scale Monthly: 10000 credits/month for $130.0/mo (rollover cap: 20000) - Enterprise Monthly: 50000 credits/month for $500.0/mo (rollover cap: 100000) - Starter Yearly: 500 credits/month for $100.0/year (rollover cap: 1000) - Growth Yearly: 3000 credits/month for $450.0/year (rollover cap: 6000) - Scale Yearly: 10000 credits/month for $1300.0/year (rollover cap: 20000) - Enterprise Yearly: 50000 credits/month for $5000.0/year (rollover cap: 100000) ## MCP Server Streamable HTTP JSON-RPC 2.0 at POST /mcp (MCP 2025-11-25) Use initialize, notifications/initialized, tools/list, tools/call, resources/list, resources/read Authorization: Bearer Legacy GET discovery and POST {tool_name, arguments} remain available ## Public Transparency GET /v1/public/pricing returns standard packs and subscription plans GET /v1/public/hit-rates returns k-anonymized global hit rates ## Status Page GET /status ## Docs https://docs.qannasapi.com (this site — quickstart, guides, pricing, status) https://docs.qannasapi.com/reference (full API reference) https://docs.qannasapi.com/spec.json (the public OpenAPI 3.1 spec)