> ## Documentation Index > Fetch the complete documentation index at: https://getanyapi.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # People Search - Prospeo > Prospect Prospeo's contact database by job title, department, seniority, experience, location and any company firmographic. One flat price per page of 25. **Price:** \$66.00 per 1,000 requests (flat per request - same cost regardless of results returned). **Routing:** one lane serves this API today, so a failed attempt has nowhere to fail over to. Payment outcome follows the selected rail's settlement policy. **Catalog:** [People Search - Prospeo pricing and uptime](https://getanyapi.com/api/people-search/prospeo) - live USD price, lane routing, and measured 30-day uptime. [Every People_search endpoint](https://getanyapi.com/api/people-search). ## OpenAPI ````yaml /openapi.json post /v1/run/people_search.prospeo openapi: 3.1.0 info: contact: email: support@getanyapi.com description: >- Any API, one wallet, USD, no subscriptions. Each API is a single discovered operation: send the normalized input, get a normalized result. Prices and payment outcomes are reported in USD; each operation documents the settlement policy for its enabled payment rails. title: AnyAPI version: 1.0.0 x-guidance: >- Use each operation's published method and path with its normalized JSON input (see the operation requestBody). Before setting a client or tool timeout, GET /v1/apis/{sku} and inspect its trailing-30-day latency p50/p95/p99 and sample; p99 is an observation, not a maximum. To pay: send your AnyAPI key (Authorization: Bearer, billed from your USD wallet). For operations that advertise an inline rail, pay per call inline with x402 - call with no key, receive HTTP 402 with a PAYMENT-REQUIRED header, then retry with the PAYMENT-SIGNATURE header (base, no account needed); or pay per call inline with MPP (Machine Payments Protocol) - call with no key, receive HTTP 402 with a WWW-Authenticate: Payment challenge, then retry with the Authorization: Payment header (tempo, no account needed). x402 settles after execution; execution failure is reported as released; mpp settles before execution; execution failure is reported as charged_undelivered. servers: - url: https://api.getanyapi.com security: - bearerAuth: [] - apiKeyAuth: [] tags: - name: ahrefs x-group: Ahrefs - name: airbnb x-group: Airbnb - name: alibaba x-group: Alibaba - name: amazon x-group: Amazon - name: apollo x-group: Apollo - name: appstore x-group: Appstore - name: bluesky x-group: Bluesky - name: booking x-group: Booking - name: capterra x-group: Capterra - name: chatgpt x-group: Chatgpt - name: coinmarketcap x-group: Coinmarketcap - name: company x-group: Company - name: company-enrichment x-group: Company_enrichment - name: company-search x-group: Company_search - name: congress x-group: Congress - name: dexscreener x-group: Dexscreener - name: douyin x-group: Douyin - name: ebay x-group: Ebay - name: email x-group: Email - name: email-finding x-group: Email_finding - name: email-verification x-group: Email_verification - name: facebook x-group: Facebook - name: fiverr x-group: Fiverr - name: g2 x-group: G2 - name: gemini x-group: Gemini - name: github x-group: Github - name: glassdoor x-group: Glassdoor - name: google x-group: Google - name: google-ads x-group: Google Ads - name: google-finance x-group: Google Finance - name: google-shopping x-group: Google Shopping - name: hackernews x-group: Hackernews - name: indeed x-group: Indeed - name: instagram x-group: Instagram - name: job-search x-group: Job_search - name: linkedin x-group: Linkedin - name: maps x-group: Maps - name: mobile-phone x-group: Mobile_phone - name: naver x-group: Naver - name: pandaexpress x-group: Pandaexpress - name: people-search x-group: People_search - name: perplexity x-group: Perplexity - name: person x-group: Person - name: person-enrichment x-group: Person_enrichment - name: pinterest x-group: Pinterest - name: playstore x-group: Playstore - name: polymarket x-group: Polymarket - name: realtor x-group: Realtor - name: reddit x-group: Reddit - name: redfin x-group: Redfin - name: rednote x-group: Rednote - name: sec x-group: Sec - name: semrush x-group: Semrush - name: seo x-group: Seo - name: snapchat x-group: Snapchat - name: social x-group: Social - name: spotify x-group: Spotify - name: substack x-group: Substack - name: technographics x-group: Technographics - name: threads x-group: Threads - name: tiktok x-group: TikTok - name: tiktok-shop x-group: TikTok Shop - name: tripadvisor x-group: Tripadvisor - name: trustpilot x-group: Trustpilot - name: truthsocial x-group: Truthsocial - name: twitter x-group: X (Twitter) - name: upwork x-group: Upwork - name: walmart x-group: Walmart - name: web x-group: Web - name: weibo x-group: Weibo - name: yahoo-finance x-group: Yahoo Finance - name: yelp x-group: Yelp - name: youtube x-group: YouTube - name: zhihu x-group: Zhihu - name: zillow x-group: Zillow paths: /v1/run/people_search.prospeo: post: tags: - people-search summary: People Search - Prospeo description: >- Prospect Prospeo's contact database by job title, department, seniority, experience, location and any company firmographic. One flat price per page of 25. **Price:** \$66.00 per 1,000 requests (flat per request - same cost regardless of results returned). **Routing:** one lane serves this API today, so a failed attempt has nowhere to fail over to. Payment outcome follows the selected rail's settlement policy. **Catalog:** [People Search - Prospeo pricing and uptime](https://getanyapi.com/api/people-search/prospeo) - live USD price, lane routing, and measured 30-day uptime. [Every People_search endpoint](https://getanyapi.com/api/people-search). operationId: people_search_prospeo parameters: - description: >- Optional. Comma-separated keys (dotted paths like `author.name` descend into nested objects) to keep on each result item. Keys are matched relative to each result item after the `data`/`items` envelope is unwrapped, not against the top-level response envelope, so use `jq` to reshape the whole envelope. Shrinks the response without changing cost. in: query name: fields required: false schema: type: string - description: >- Optional. Cap the number of result rows returned; a `_truncated` note reports how many were withheld so you can page via the API's own `limit`. Does not change cost. in: query name: max_items required: false schema: minimum: 0 type: integer - description: >- Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost. in: query name: summary required: false schema: type: boolean - description: >- Optional. A jq expression applied to the result envelope; its output replaces `output` (multiple outputs collect into an array). Reshape freely, e.g. `jq=.data | {title, description, md: .markdown[:3500]}`. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a `jqError`. Does not change cost. in: query name: jq required: false schema: type: string - description: >- Optional wallet idempotency key, scoped to this customer for 24 hours. When the gateway honors the key, this synchronous in-process execution can continue after the caller disconnects, bounded by its execution deadline. A completed replayable result charges normally exactly once and can be replayed without another provider run or charge. A pending duplicate returns 409 idempotency_in_progress; reuse with different request semantics returns 409 idempotency_conflict. in: header name: Idempotency-Key required: false schema: maxLength: 255 minLength: 1 type: string requestBody: content: application/json: example: company: websites: include: - stripe.com page: 1 schema: additionalProperties: false example: company: websites: include: - stripe.com page: 1 minProperties: 1 properties: company: additionalProperties: true description: >- Filter by company names or websites, e.g. {"names": {"include": ["Stripe"]}, "websites": {"include": ["stripe.com"]}}. type: object companyAttributes: additionalProperties: true description: >- Filter by company characteristics, e.g. B2B, has pricing, has a free trial. type: object companyEmailProvider: description: Filter by the company's email MX provider. items: type: string type: array companyFounded: additionalProperties: true description: Filter by founding year range. type: object companyFunding: additionalProperties: true description: Filter by funding stage or amount raised. type: object companyHeadcountByDepartment: description: Filter by headcount within a department. items: type: string type: array companyHeadcountCustom: additionalProperties: true description: Filter by a custom employee count range. type: object companyHeadcountGrowth: additionalProperties: true description: Filter by headcount growth. type: object companyHeadcountRange: description: Filter by Prospeo's predefined employee count bands. items: type: string type: array companyIndustry: additionalProperties: true description: Filter by company industry. type: object companyJobPostingHiringFor: description: Filter by the roles the company is currently hiring for. items: type: string type: array companyJobPostingQuantity: additionalProperties: true description: Filter by how many roles the company has open. type: object companyKeywords: additionalProperties: true description: Filter by keywords found in company data. type: object companyLocationSearch: additionalProperties: true description: Filter by company headquarters location. type: object companyNaics: additionalProperties: true description: Filter by NAICS codes. type: object companyRevenue: additionalProperties: true description: Filter by revenue range. type: object companySics: additionalProperties: true description: Filter by SIC codes. type: object companyTechnology: additionalProperties: true description: Filter by technologies the company uses. type: object companyType: description: Filter by ownership type. enum: - Private - Public - Non Profit - Other type: string maxPersonPerCompany: description: >- Cap how many people one company may contribute to the results. minimum: 1 type: integer page: default: 1 description: >- Page number, one-based. Prospeo returns 25 results per page and charges one flat price per page. minimum: 1 type: integer personContactDetails: additionalProperties: true description: >- Filter by which contact channels Prospeo holds for the person. type: object personDepartment: additionalProperties: true description: Filter by department. type: object personDuplicateControl: additionalProperties: true description: >- Duplicate-control settings exported from the Prospeo dashboard. type: object personJobTitle: additionalProperties: true description: >- Filter by job title, with exact, contains and boolean semantics, e.g. {"include": ["VP Sales"]}. type: object personLocationSearch: additionalProperties: true description: Filter by where the person is located. type: object personName: additionalProperties: true description: Filter by person name. type: object personNameOrJobTitle: description: Free-text search across person name and job title. type: string personSeniority: additionalProperties: true description: >- Filter by seniority. Prospeo's own values are case sensitive: Founder/Owner, C-Suite, Partner, Vice President, Head, Director, Manager, Senior, Entry, Intern. Common aliases such as vp and founder are normalized before the call. type: object personTimeInCurrentCompany: additionalProperties: true description: Filter by time at the current company, as a numeric range. type: object personTimeInCurrentRole: additionalProperties: true description: Filter by time in the current role, as a numeric range. type: object personYearOfExperience: additionalProperties: true description: Filter by total years of experience, as a numeric range. type: object preferLatencyUnderMs: description: >- Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. minimum: 1 type: integer title: People Search - Prospeo input type: object required: true responses: '200': content: application/json: schema: properties: costUsd: description: >- USD charged on the original run. On a replay this value is echoed for parity; the replay itself is free. type: number hint: description: >- Optional one-line nudge, absent when there is nothing to say. `large_result:` suggests the fields/max_items/summary/jq controls for a big response. `paging_unavailable:` means this result came from a source that cannot return a `nextCursor`, so it may be INCOMPLETE and cannot be continued - re-run with `requireCursor: true` to be served only by a source that can page, which may cost more per request. type: string items: description: >- Number of result rows returned. For per-result SKUs the per-item cost is charged against this count; for input-priced SKUs the charge is per submitted input, independent of this count. type: integer jqError: description: >- Present only when a `jq` expression failed; `output` then carries the full unshaped result and this explains why the reshape did not apply. type: string output: anyOf: - additionalProperties: false properties: data: description: >- One page of matching records plus Prospeo's paging counters. oneOf: - type: 'null' - additionalProperties: false properties: currentPage: description: >- Page number this response holds, one-based. type: integer people: description: >- Matching people, each with their current employer's firmographic record. Email addresses and mobile numbers come back masked; reveal them with Person Enrichment - Prospeo. items: properties: company: description: >- The person's current employer, with Prospeo's full firmographic record. properties: attributes: description: >- What Prospeo detects about how the company sells. properties: hasDemo: description: The website offers a demo. type: boolean hasDownloadable: description: The website offers a download. type: boolean hasFreeTrial: description: The website offers a free trial. type: boolean hasMobileApps: description: The company publishes mobile apps. type: boolean hasOnlineReviews: description: The company has online reviews. type: boolean hasPricing: description: The website publishes pricing. type: boolean isB2b: description: The company sells to businesses. type: boolean type: object companyId: description: >- Prospeo's own company identifier. Send it back as this SKU's companyId input. type: string crunchbaseUrl: description: Company Crunchbase profile URL. format: uri type: string description: description: >- Company description as the company writes it. type: string descriptionAi: description: >- Prospeo's own AI-written company summary. type: string descriptionSeo: description: >- Meta description from the company's website. type: string domain: description: Primary company domain. type: string emailTech: description: How the company's email is hosted. properties: domain: description: >- Domain the company's email addresses use. type: string mxProvider: description: >- Mail provider behind the domain's MX records. type: string type: object employeeCount: description: Employees Prospeo currently counts. type: integer employeeCountOnProspeo: description: >- Employees of this company that Prospeo holds a profile for. type: integer employeeRange: description: Employee headcount band, e.g. 10000+. type: string facebookUrl: description: Company Facebook page URL. format: uri type: string founded: description: Year the company was founded. type: integer funding: description: Funding history. properties: events: description: One entry per funding round. items: properties: amount: description: Amount raised in USD. type: number amountPrinted: description: Amount raised as a display string. type: string link: description: Source URL for the round. format: uri type: string raisedUtc: description: >- UTC epoch timestamp in seconds (Unix time) the round closed. Multiply by 1000 for a JS Date in milliseconds. type: number stage: description: Round stage, e.g. Series E-J. type: string type: object type: array latestStage: description: Most recent funding stage. type: string latestUtc: description: >- UTC epoch timestamp in seconds (Unix time) of the most recent round. Multiply by 1000 for a JS Date in milliseconds. type: number rounds: description: Number of funding rounds raised. type: integer totalRaised: description: Total capital raised, in USD. type: number totalRaisedPrinted: description: >- Total capital raised as a display string. type: string type: object image: description: Company logo URL. format: uri type: string industry: description: Company industry. type: string instagramUrl: description: Company Instagram profile URL. format: uri type: string jobPostings: description: >- Open roles Prospeo currently sees for the company. properties: activeCount: description: Open roles currently posted. type: integer activeTitles: description: Titles of the open roles. items: type: string type: array type: object keywords: description: Keywords Prospeo assigns the company. items: type: string type: array linkedinId: description: Company LinkedIn numeric id. type: string linkedinUrl: description: Company LinkedIn page URL. format: uri type: string location: description: Company headquarters. properties: city: description: City. type: string country: description: Country name. type: string countryCode: description: ISO 3166-1 alpha-2 country code. type: string rawAddress: description: >- Headquarters address as one display string. type: string state: description: State or region. type: string type: object naicsCodes: description: >- NAICS classification codes for the company. items: type: string type: array name: description: Company name. type: string otherWebsites: description: Other domains the company owns. items: type: string type: array phoneHq: description: Headquarters switchboard number. properties: country: description: Country the number belongs to. type: string countryCode: description: >- ISO 3166-1 alpha-2 code for that country. type: string international: description: Number in international format. type: string national: description: Number in national format. type: string phone: description: Phone number as Prospeo stores it. type: string type: object revenueRange: description: Annual revenue band in USD. properties: max: description: Upper bound in USD. type: number min: description: Lower bound in USD. type: number type: object revenueRangePrinted: description: Annual revenue band as a display string. type: string sicCodes: description: >- SIC classification codes for the company. items: type: string type: array technologies: description: >- Technologies Prospeo detects in the company's stack. items: type: string type: array twitterUrl: description: Company X (Twitter) profile URL. format: uri type: string type: description: >- Ownership type, e.g. Private, Public, Non Profit. type: string website: description: Company website URL. format: uri type: string youtubeUrl: description: Company YouTube channel URL. format: uri type: string type: object email: description: >- Work email address. Prospeo returns the address only once it is revealed; status says why it is absent otherwise. properties: email: description: >- The email address, when Prospeo revealed one. type: string revealed: description: >- True when the address below is the full value rather than a masked preview. type: boolean status: description: >- Prospeo's verdict for the address, e.g. VERIFIED or UNAVAILABLE. type: string type: object firstName: description: First name. type: string fullName: description: Person's full name. type: string headline: description: LinkedIn headline. type: string jobChangeDetectedUtc: description: >- UTC epoch timestamp in seconds (Unix time) Prospeo last detected a job change. Multiply by 1000 for a JS Date in milliseconds. type: number jobHistory: description: >- Every role Prospeo holds for the person, most recent first. items: properties: companyId: description: Prospeo company id for the employer. type: string companyName: description: Employer name. type: string current: description: True while the role is current. type: boolean departments: description: Departments Prospeo assigns the role. items: type: string type: array durationMonths: description: How long the role has run, in months. type: integer endMonth: description: >- Month the role ended, absent while current. type: integer endYear: description: >- Year the role ended, absent while current. type: integer jobKey: description: Prospeo's identifier for this role. type: string seniority: description: >- Seniority band, e.g. C-Suite, Manager, Entry. type: string startMonth: description: Month the role started, 1 to 12. type: integer startYear: description: Year the role started. type: integer title: description: Job title held. type: string type: object type: array jobKey: description: >- Prospeo's identifier for the current role. type: string jobTitle: description: Current job title. type: string lastName: description: Last name. type: string linkedinMemberId: description: LinkedIn numeric member id. type: string linkedinUrl: description: LinkedIn profile URL. format: uri type: string location: description: Where the person is located. properties: city: description: City. type: string country: description: Country name. type: string countryCode: description: ISO 3166-1 alpha-2 country code. type: string state: description: State or region. type: string timeZone: description: IANA time zone, e.g. America/New_York. type: string timeZoneOffset: description: Current offset from UTC in hours. type: number type: object mobile: description: >- Mobile phone number. Digits are masked until the number is revealed; send enrichMobile to reveal it. properties: country: description: Country the number belongs to. type: string countryCode: description: >- ISO 3166-1 alpha-2 code for that country. type: string international: description: Number in international format. type: string mobile: description: The number as Prospeo stores it. type: string national: description: Number in national format. type: string revealed: description: >- True when the digits below are the full number rather than a masked preview. type: boolean status: description: >- Prospeo's verdict for the number, e.g. VERIFIED or UNAVAILABLE. type: string type: object personId: description: >- Prospeo's own person identifier. Send it back as this SKU's personId input. type: string skills: description: Skills the person lists. items: type: string type: array required: - fullName type: object type: array perPage: description: >- Results Prospeo returns per page. Prospeo fixes this at 25 and charges one flat price per page. type: integer totalCount: description: >- Results matching the filters across all pages. type: integer totalPages: description: Pages of results behind these filters. type: integer required: - people type: object found: description: False when no record matched the filters. type: boolean required: - found - data title: People Search - Prospeo output type: object - type: 'null' description: >- Normalized output, or null when the replay payload was not retained. provider: description: Always "AnyAPI". type: string replayed: description: >- True when this response replays the durable result of an earlier run without billing or upstream execution. type: boolean resultId: description: >- Opaque handle to the full unshaped result, cached ~15 min. Re-shape it for free (fields/max_items/summary/jq) via GET /v1/results/{id}, no re-billing. Absent when the result was too large to cache. type: string required: - output - provider - costUsd - items - replayed type: object description: Normalized result. headers: Idempotency-Replayed: description: >- Present only when the request carried an Idempotency-Key this gateway honored. "false" means the key was claimed and the run executed freshly; "true" means it replayed a prior identical run and was NOT charged again. Absent means either no key was sent or this gateway does not honor keys, so a retry could be charged twice. schema: enum: - 'false' - 'true' type: string PAYMENT-RESPONSE: description: Inline x402 payment receipt. schema: type: string Payment-Receipt: description: Inline mpp payment receipt. schema: type: string X-PAYMENT-RESPONSE: description: Inline x402 payment receipt. schema: type: string '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Input did not match the schema, or the upstream rejected the request. '401': content: application/json: schema: $ref: '#/components/schemas/Error' description: Missing or invalid API key. '402': content: application/json: schema: oneOf: - $ref: '#/components/schemas/PaymentRequiredError' - $ref: '#/components/schemas/TrialCapReached' application/problem+json: schema: properties: challengeId: minLength: 1 type: string status: const: 402 type: integer required: - status - challengeId type: object description: >- Insufficient wallet balance or spend cap, or an inline-payment challenge. Agent trials receive a trial_cap_reached continuation with a live RFC 8628 device authorization. headers: PAYMENT-REQUIRED: description: Inline x402 payment challenge. schema: type: string WWW-Authenticate: description: Inline mpp payment challenge. schema: type: string '404': content: application/json: schema: $ref: '#/components/schemas/Error' description: Unknown SKU, or the upstream had no matching resource. '409': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Idempotency collision. Codes: idempotency_in_progress means retry after the Retry-After delay; idempotency_conflict means use a new key for different request semantics; idempotency_needs_review means stop retrying and contact AnyAPI support with X-Anyapi-Request-Id. '422': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- The request was well formed but this API cannot serve the requested target site; the body's `alternatives` array lists the AnyAPI APIs that can. '429': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- The upstream was rate limited; inspect `payment` when present before deciding whether to retry. '500': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- An internal error prevented completion. Inspect payment when present before retrying. '502': content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Every provider failed with a server/transport error, or inline payment settlement could not be confirmed; inspect `payment` when present before retrying. security: - bearerAuth: [] - apiKeyAuth: [] - {} components: schemas: Error: properties: code: description: Stable machine-readable error code when the endpoint defines one. type: string error: description: Customer-safe error message. type: string payment: $ref: '#/components/schemas/Payment' requestId: description: >- This run's AnyAPI request id, the same value as the X-Anyapi-Request-Id response header. Quote it to support. Absent on endpoints that do not execute a run. format: uuid type: string required: - error type: object PaymentRequiredError: allOf: - $ref: '#/components/schemas/Error' - properties: error: not: const: trial_cap_reached type: object TrialCapReached: properties: error: const: trial_cap_reached type: string message: description: >- Human-relayable continuation instructions, including an executable token poll. type: string upgrade: $ref: '#/components/schemas/AgentUpgrade' required: - error - message - upgrade type: object Payment: properties: costUsd: description: Known USD payment amount for this request. minimum: 0 type: number rail: minLength: 1 type: string settlementState: enum: - charged_undelivered - indeterminate type: string required: - rail - settlementState - costUsd type: object AgentUpgrade: properties: authorizationServer: format: uri type: string clientId: type: string device: $ref: '#/components/schemas/DeviceUpgrade' scope: type: string required: - authorizationServer - scope type: object DeviceUpgrade: properties: deviceCode: type: string expiresIn: minimum: 0 type: integer grantType: type: string interval: minimum: 1 type: integer tokenEndpoint: format: uri type: string userCode: type: string verificationUri: format: uri type: string verificationUriComplete: format: uri type: string required: - verificationUriComplete - verificationUri - userCode - deviceCode - tokenEndpoint - grantType - interval - expiresIn type: object securitySchemes: bearerAuth: description: Your AnyAPI key as a Bearer token. scheme: bearer type: http x-default: YOUR_ANYAPI_KEY apiKeyAuth: description: Your AnyAPI key. in: header name: X-API-Key type: apiKey x-default: YOUR_ANYAPI_KEY ````