- X/Twitter
- Google Maps
- FullEnrich
- Minerva
- Exa
- Firecrawl
- Clado
- Serper
- Whitepages
- Hunter
Data API Reference
39 endpoints across 11 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.
/api/google-maps/solar/building-insights$0.02Solar Building Insights
Get rooftop solar potential for the closest building to a coordinate, including imagery date.
Parameters
| latitude | required | Latitude of the location |
| longitude | required | Longitude of the location |
| requiredQuality | optional | Minimum imagery quality (e.g. "HIGH") |
Use case: Estimate rooftop solar viability and panel capacity for a property.
/api/google-maps/solar/data-layers$0.08Solar Data Layers
Get aerial GeoTIFF solar data layers (RGB, DSM, flux) for an area, with imagery date.
Parameters
| latitude | required | Latitude of the location |
| longitude | required | Longitude of the location |
| radiusMeters | optional | Radius of the area to cover, in meters |
| view | optional | Which layers to return |
| requiredQuality | optional | Minimum imagery quality |
| pixelSizeMeters | optional | Pixel resolution in meters |
Use case: Build detailed solar analyses with raw rooftop elevation and flux layers.
/api/google-maps/solar/rgb-image$0.05Solar RGB Image
Render a solar GeoTIFF layer (RGB, DSM, flux, shade, or mask) as a PNG/JPEG and return its URL.
Parameters
| id | optional | A GeoTIFF id (alternative to latitude/longitude) |
| latitude | optional | Latitude (alternative to id) |
| longitude | optional | Longitude (alternative to id) |
| layer | optional | Layer to render: rgb, dsm, flux, shade, or mask |
| month | optional | Month for monthlyFlux (single or 4x3 grid) |
| hour | optional | Hour for hourlyShade (single or 6x4 grid) |
| format | optional | Output image format (PNG or JPEG) |
Use case: Produce a shareable image of a rooftop solar layer for reports or UIs.
/api/google-maps/aerial-view/lookup-video$0.01Aerial View Lookup
Look up a previously rendered aerial flyover video by address or video ID.
Parameters
| address | optional | Address to look up (alternative to videoId) |
| videoId | optional | Video ID returned from a render request |
Use case: Retrieve a completed aerial flyover video once rendering has finished.
⚠ Pair with the render endpoint: request a render, then poll this lookup until the video is ready.
/api/google-maps/aerial-view/render-video$0.01Aerial View Render
Request rendering of a new aerial flyover video for an address.
Parameters
| address | required | Address to render an aerial flyover for |
Use case: Kick off an aerial flyover video; retrieve it later via the lookup endpoint.
⚠ Rendering is asynchronous — use Aerial View Lookup to fetch the finished video.
FullEnrich
B2B contact and company data for sales prospecting.
/api/fullenrich/people-search$0.05People Search
Search for people/contacts by company domain, seniority, title, location, and skills. Returns full contact records directly — no separate unlock step required.
Parameters
| current_company_domains | optional | Array of { value } company domains, e.g. [{ "value": "stripe.com" }] |
| current_position_seniority_level | optional | Array of { value } seniority enums (C-level, VP, Head, Founder) — prefer over titles for population queries |
| current_position_titles | optional | Array of { value } exact titles — far fewer results than seniority |
| person_locations | optional | Array of { value } locations — pair with a company domain, location alone is very broad |
| limit | optional | Max people to return (default 3, flat price regardless) |
| search_after | optional | Cursor token from metadata.search_after for pagination |
Use case: Build a targeted contact list — e.g. all VPs at a given company domain. Start with domain + seniority; adding 3+ filters often returns zero.
⚠ Use FullEnrich seniority enums (C-level, VP, Head, Founder) — Apollo-style values like c_suite return 400.
/api/fullenrich/company-search$0.05Company Search
Search for companies by legal entity name, industry, headcount, or HQ location.
Parameters
| names | optional | Array of { value } legal entity names (e.g. Anysphere, not Cursor) |
| industries | optional | Array of { value } FullEnrich industry enum strings (e.g. Software Development) |
| headquarters_locations | optional | Array of { value } HQ locations (e.g. United States) |
| headcounts | optional | Array of { min?, max? } employee-count ranges |
| limit | optional | Max companies to return (default 3) |
| search_after | optional | Cursor token from metadata.search_after for pagination |
Use case: Find and verify target companies and their domains before running people searches.
⚠ Provide at least one of names, industries, or headquarters_locations — limit/page alone returns 400.
/api/pdl/people-enrich$0.20People Enrich
Resolve a single person to their full career history, emails, and phone numbers.
Parameters
| optional | Email address — highest-reliability input; prefer when known | |
| profile | optional | LinkedIn or other social profile URL |
| first_name | optional | First name (pair with last_name + company_name or company_domain) |
| last_name | optional | Last name |
| company_name | optional | Company name (with first_name + last_name) |
| company_domain | optional | Company domain (with first_name + last_name) |
Use case: Get complete, actionable contact information for a known individual. Provide at least one identifier; email gives the most reliable match.
⚠ A no-match lookup returns HTTP 404. Prefer email > profile > name+domain.
/api/companyenrich/org-enrich$0.06Organization Enrich
Get a comprehensive company profile — size, revenue, industry, and more — by domain.
Parameters
| domain | required | Company website domain (e.g. "stripe.com") |
| expand | optional | Optional workforce breakdown (costs extra upstream credits) |
Use case: Research a company in depth by its domain — headcount and revenue ranges, industry, and firmographics.
⚠ employees/revenue are returned as range strings. Verify the returned domain matches your input.
/api/companyenrich/properties-enrich$0.06Enrich by Properties
Match and enrich a company by name or social URL when the domain is unknown, returning a full profile.
Parameters
| name | optional | Company name (best-match disambiguation) |
| linkedinUrl | optional | LinkedIn company page URL |
| twitterUrl | optional | Twitter/X company URL |
| facebookUrl | optional | Facebook company URL |
| instagramUrl | optional | Instagram company URL |
| expand | optional | Optional workforce breakdown (costs extra upstream credits) |
Use case: Enrich a company you only know by name or social profile, without a domain.
⚠ Best-match disambiguation — verify the returned domain before downstream people searches.
Minerva
Identity resolution and people enrichment — resolve, enrich, and validate person records at scale.
/api/minerva/resolve$0.02Resolve
Resolve person records to a Minerva PID and LinkedIn URL, with fuzzy and reverse lookup support.
Parameters
| records | required | Array of person records to resolve (max 1000 per request) |
| match_condition_fields | optional | Fields that must be present for a match (e.g. "minerva_pid", "linkedin_url") |
Use case: Map raw names/emails/phones to stable Minerva identities before enrichment.
/api/minerva/enrich$0.05Enrich
Enrich person records with demographics, work history, education, contact info, addresses, and financial signals.
Parameters
| records | required | Array of person records to enrich (max 500 per request) |
| match_condition_fields | optional | Fields that must be present for a match |
| return_fields | optional | Fields to return beyond base fields (omit to return all) |
Use case: Build full person profiles by Minerva PID, LinkedIn URL, or name/email/phone.
/api/minerva/validate-emails$0.01Validate Emails
Check whether email addresses exist in the Minerva database and get validation status and last-seen timestamps.
Parameters
| records | required | Array of email address strings to validate (max 2000 per request) |
Use case: Validate and prioritize a list of email addresses before outreach.
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 people-search lacks direct emails or phone numbers for newer accounts.
⚠ Provide exactly one of: linkedin_url, email, or phone.
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.
/api/serper/images$0.04Images Search
Search Google Images for pictures matching a query.
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") |
| location | optional | Location (e.g. "New York, NY") |
Use case: Find images for a topic, product, or brand.
/api/serper/people-image-search$0.04People Image Search
Google Images search tuned for finding photos/headshots of a specific person.
Parameters
| q | required | Exact-name + company/context query, e.g. '"Jane Doe" "Acme" headshot' |
| num | optional | Number of results to return |
| gl | optional | Country code for localized results |
| hl | optional | Language code |
| location | optional | Location (e.g. "New York, NY") |
Use case: Find a headshot for a known person; resolve their company/title first for ambiguous names.
/api/serper/lens$0.20Lens Reverse Image Search
Reverse-image search a public image URL with Google Lens.
Parameters
| url | required | Public URL of the image to reverse-search |
| gl | optional | Country code for localized results |
| hl | optional | Language code |
Use case: Identify the source, subject, or similar images for a given picture.
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.22Person 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.22Property 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.
For authentication, credit topups, and other API endpoints, see the API documentation →