- X/Twitter
- Google Maps
- Apollo
- Exa
- Firecrawl
- Clado
- Serper
- Whitepages
- Hunter
- Influencer
Data API Reference
27 endpoints across 10 providers — all accessible via your PPQ API key at https://api.ppq.ai/v1/data
Each call deducts from your PPQ credit balance. Authentication: Authorization: Bearer YOUR_API_KEY
X/Twitter
Real-time X/Twitter data — search tweets, look up users, browse lists, communities, and more.
/x/tweets/search$0.01Tweet Search
Search tweets with advanced filters: keywords, phrase matching, hashtags, user filters, engagement minimums, and date ranges.
Parameters
| words | optional | All these words must appear |
| phrase | optional | Exact phrase match |
| anyWords | optional | Any of these words |
| noneWords | optional | Exclude these words |
| hashtags | optional | Filter by hashtag |
| from | optional | Tweets from this username |
| to | optional | Tweets replying to this username |
| mentioning | optional | Tweets mentioning this username |
| minReplies | optional | Minimum reply count |
| minLikes | optional | Minimum like count |
| minReposts | optional | Minimum retweet count |
| since | optional | Start date (YYYY-MM-DD) |
| until | optional | End date (YYYY-MM-DD) |
| next_token | optional | Pagination cursor |
Use case: Monitor conversations, track trends, or find tweets matching specific criteria.
⚠ At least one search parameter is required. Returns up to 20 tweets per page.
/x/tweets/by/id$0.01Tweet by ID
Retrieve a specific tweet by its ID with full metadata and engagement metrics.
Parameters
| id | required | Tweet ID |
Use case: Get full details for a specific tweet.
/x/tweets/user$0.01User Tweets
Get a user's recent tweets with engagement metrics.
Parameters
| username | required | Twitter/X username (without @) |
| next_token | optional | Pagination cursor |
Use case: Browse a user's tweet timeline.
/x/tweets/replies$0.01Tweet Replies
Get replies to a specific tweet.
Parameters
| id | required | Tweet ID |
| next_token | optional | Pagination cursor |
Use case: Read the conversation thread under a tweet.
/x/tweets/quote_tweets$0.01Quote Tweets
Get quote tweets of a specific tweet.
Parameters
| id | required | Tweet ID |
| next_token | optional | Pagination cursor |
Use case: See how people are quoting and commenting on a tweet.
/x/tweets/retweeted_by$0.01Retweeted By
Get users who retweeted a specific tweet.
Parameters
| id | required | Tweet ID |
| next_token | optional | Pagination cursor |
Use case: Identify who is amplifying a tweet.
/x/users/search$0.01User Search
Search for X/Twitter users by keyword.
Parameters
| query | required | Search query |
| next_token | optional | Pagination cursor |
Use case: Find users matching specific criteria.
/x/users/by/id$0.01User by ID
Look up a user by their numeric ID.
Parameters
| id | required | User ID |
Use case: Get user profile details from an ID.
/x/users/by/username$0.01User by Username
Look up a user by their @username.
Parameters
| username | required | Twitter/X username (without @) |
Use case: Get user profile details from a handle.
/x/users/followers$0.01User Followers
Get a user's followers.
Parameters
| id | required | User ID |
| next_token | optional | Pagination cursor |
Use case: Analyze follower base of an account.
/x/users/following$0.01User Following
Get accounts a user is following.
Parameters
| id | required | User ID |
| next_token | optional | Pagination cursor |
Use case: See who an account follows for network analysis.
/x/lists/by/id$0.01List by ID
Get details for a specific X/Twitter list.
Parameters
| id | required | List ID |
Use case: Look up list metadata.
Google Maps
Search and retrieve place data powered by Google Maps.
/api/google-maps/text-search/full$0.08Text Search (Full)
Search for places using a text query with full details including ratings, reviews, contact info, and atmosphere data.
Parameters
| textQuery | required | Search query string |
| maxResultCount | optional | Maximum number of results to return |
| pageToken | optional | Token for paginating through results |
Use case: Find businesses, landmarks, or points of interest with complete information.
/api/google-maps/text-search/partial$0.02Text Search (Partial)
Search for places using a text query, returning basic fields only (name, address, location). Lower cost alternative to the full version.
Parameters
| textQuery | required | Search query string |
| maxResultCount | optional | Maximum number of results to return |
| pageToken | optional | Token for paginating through results |
Use case: Get a list of matching places when you only need names and addresses.
/api/google-maps/nearby-search/full$0.08Nearby Search (Full)
Find places near a geographic coordinate with full details.
Parameters
| locationRestriction | required | Circle with center (lat/lng) and radius in meters |
| maxResultCount | optional | Maximum number of results to return |
Use case: Discover all restaurants, shops, or services within a given radius of a location.
/api/google-maps/nearby-search/partial$0.02Nearby Search (Partial)
Find places near a geographic coordinate, returning basic fields only.
Parameters
| locationRestriction | required | Circle with center (lat/lng) and radius in meters |
| maxResultCount | optional | Maximum number of results to return |
Use case: Get a list of nearby places when you only need names and locations.
/api/google-maps/place-details/full$0.05Place Details (Full)
Retrieve complete details for a specific place by its Google Place ID.
Parameters
| placeId | required | Google Place ID for the location |
Use case: Get all available data for a known place — hours, phone, website, reviews, and more.
/api/google-maps/place-details/partial$0.02Place Details (Partial)
Retrieve basic details for a specific place by its Google Place ID.
Parameters
| placeId | required | Google Place ID for the location |
Use case: Get essential place info (name, address, coordinates) for a known Place ID at lower cost.
Apollo
B2B contact and company data for sales prospecting.
/api/apollo/people-search$0.02People Search
Search for people matching criteria such as job title, location, or keywords. Returns obfuscated names that must be enriched with the people-enrich endpoint to reveal full contact details.
Parameters
| q_keywords | optional | Keywords to filter by (name, title, company) |
| person_locations | optional | Array of location strings to filter by |
| per_page | optional | Results per page (default 25) |
| page | optional | Page number for pagination |
Use case: Find a list of professionals matching your target profile before enriching for contact details.
⚠ Results have obfuscated names. Always follow up with people-enrich to reveal full information.
/api/apollo/org-search$0.02Organization Search
Search for companies by keywords, location, or industry to find and verify organization IDs.
Parameters
| q_keywords | optional | Keywords to filter companies by |
| organization_locations | optional | Array of location strings |
| per_page | optional | Results per page |
Use case: Verify exact organization identifiers and domains before using them in people searches.
/api/apollo/people-enrich$0.05People Enrich
Reveal full contact details for a person — unobfuscated name, email, phone, and profile data.
Parameters
| required | Email address of the person to enrich |
Use case: Get complete, actionable contact information for individuals found via people-search.
⚠ Required follow-up step after people-search to access real names and contact details.
/api/apollo/org-enrich$0.05Organization Enrich
Get a comprehensive company profile including size, funding, industry, and tech stack by domain.
Parameters
| domain | required | Company website domain (e.g. "acme.com") |
Use case: Research a company in depth — headcount, funding rounds, technology used, and key contacts.
Exa
Neural web search — find and extract web content semantically.
/api/exa/search$0.01Search
Semantic web search that finds the most relevant pages for a query. Supports filtering by content category.
Parameters
| query | required | Search query |
| numResults | optional | Number of results (up to 100) |
| category | optional | Filter by type: company, research paper, news, pdf, github, tweet, personal site, linkedin profile, financial report |
Use case: Find relevant web pages, LinkedIn profiles, research papers, or news articles on any topic.
/api/exa/find-similar$0.01Find Similar
Find web pages that are semantically similar to a given URL.
Parameters
| url | required | URL to find similar pages for |
| numResults | optional | Number of results to return |
Use case: Competitive research — find similar companies, articles, or resources to a known URL.
/api/exa/contents$0.002Contents
Extract and return the text content from a list of URLs. The cheapest bulk extraction option.
Parameters
| urls | required | Array of URLs to extract content from |
Use case: Bulk extraction of web page text when cost is a priority.
/api/exa/answer$0.01Answer
Get an AI-generated answer to a question, grounded in live web search results.
Parameters
| query | required | Question to answer |
Use case: Get a direct, sourced answer to a factual question without manually reviewing search results.
Firecrawl
Web scraping with clean markdown output.
/api/firecrawl/scrape$0.01Scrape
Scrape a web page and return its content as clean, formatted markdown. Handles JavaScript-rendered pages.
Parameters
| url | required | URL of the page to scrape |
Use case: Extract full page content from any URL with clean, LLM-ready markdown output.
/api/firecrawl/search$0.03Search
Search the web and return pre-scraped full content for each result.
Parameters
| query | required | Search query |
| limit | optional | Maximum number of results to return |
Use case: Web search that returns full page content (not just snippets) for each result.
Clado
LinkedIn profile and contact enrichment.
/api/clado/contacts-enrich$0.20Contacts Enrich
Enrich contact information from a LinkedIn URL, email address, or phone number. Returns personal emails, phone numbers, and profile data.
Parameters
| linkedin_url | optional | LinkedIn profile URL (provide exactly one of the three identifiers) |
| optional | Email address | |
| phone | optional | Phone number |
Use case: Get personal contact details for a prospect, especially when Apollo lacks direct emails or phone numbers for newer accounts.
⚠ Provide exactly one of: linkedin_url, email, or phone.
/api/clado/linkedin-scrape$0.04LinkedIn Scrape
Scrape a full LinkedIn profile including work experience, education, skills, and recent posts.
Parameters
| linkedin_url | required | LinkedIn profile URL to scrape |
Use case: Get a comprehensive view of a person's professional background from their LinkedIn profile.
Serper
Google Search results via Serper.dev.
/api/serper/news$0.04News Search
Search Google News for recent articles and news coverage on any topic.
Parameters
| q | required | Search query |
| num | optional | Number of results to return |
| gl | optional | Country code for localized results (e.g. "us") |
| hl | optional | Language code (e.g. "en") |
Use case: Monitor news coverage about a company, person, or topic.
/api/serper/shopping$0.04Shopping Search
Search Google Shopping for product listings with prices and seller information.
Parameters
| q | required | Product search query |
| num | optional | Number of results to return |
| gl | optional | Country code for localized results |
| hl | optional | Language code |
Use case: Product research, price comparison, and market intelligence.
Search Reddit posts and retrieve full thread discussions.
/api/reddit/search$0.02Search
Search Reddit posts by query. Returns post previews with selftext truncated to 500 characters.
Parameters
| query | required | Search query |
| sort | optional | Sort order: relevance, hot, top, new, comments |
| timeframe | optional | Time filter: hour, day, week, month, year, all |
| maxResults | optional | Maximum number of posts to return |
Use case: Discover Reddit discussions about a topic, product, or question.
⚠ selftext is truncated to 500 characters. Use the post-comments endpoint to fetch full content of specific posts.
/api/reddit/post-comments$0.02Post Comments
Retrieve the full post content and all comments for a specific Reddit post by its URL.
Parameters
| url | required | Reddit post permalink URL |
Use case: Deep-dive into a specific Reddit thread to read full discussions and community sentiment.
⚠ Two-step pattern: use the search endpoint first to find relevant posts, then use this to read full content.
Whitepages
US people and property records.
/api/whitepages/person-search$0.44Person Search
Look up a person by name and location. Returns contact information, address history, and associated people.
Parameters
| first_name | required | First name of the person |
| last_name | required | Last name of the person |
| state_code | required | 2-letter US state abbreviation (e.g. "CA") |
Use case: Background checks, people locating, and contact verification for US individuals.
⚠ Use state_code (2-letter abbreviation), not "state".
/api/whitepages/property-search$0.44Property Search
Look up property ownership, current residents, and property details by address.
Parameters
| street | required | Street address (e.g. "123 Main St") |
| city | required | City name |
| state_code | required | 2-letter US state abbreviation (e.g. "CA") |
Use case: Real estate research, property ownership verification, and skip tracing.
⚠ Use state_code (2-letter abbreviation), not "state".
Hunter
Email verification and deliverability checking.
/api/hunter/email-verifier$0.03Email Verifier
Verify an email address for deliverability. Returns status (valid, invalid, risky, unknown), SMTP check results, and mail server details.
Parameters
| required | Email address to verify |
Use case: Clean email lists, validate contacts before outreach, and reduce bounce rates.
Influencer
Social media profile enrichment and influencer discovery.
/api/influencer/enrich-by-email$0.40Enrich by Email
Find and enrich social media profiles associated with an email address.
Parameters
| required | Email address to look up | |
| platform | required | Platform to search: instagram, tiktok, youtube, facebook |
| enrichment_mode | optional | Enrichment depth (e.g. "enhanced") |
Use case: Discover a person's social media presence and influence from their email address.
/api/influencer/enrich-by-social$0.40Enrich by Social
Get a comprehensive influencer profile including follower counts, engagement metrics, and contact information from a social handle.
Parameters
| platform | required | Platform: instagram, tiktok, youtube, facebook |
| username | required | Social media username/handle |
| enrichment_mode | optional | Enrichment depth (e.g. "enhanced") |
| email_required | optional | Whether to require email in the response |
Use case: Research influencer reach and get contact details for outreach campaigns.
For authentication, credit topups, and other API endpoints, see the API documentation →