find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/prospectapis:prospectapis-account-insights-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: ProspectAPIs Account insights API
  summary: Funding signals and cited prospect research over one REST API.
  description: 'The REST contract for ProspectAPIs: funding rounds you can filter and page, cited prospect research briefs, and funding watchlists that push new matches to a webhook. Built for sales teams and the AI agents that work for them.


    Authentication is a bearer API key (`Authorization: Bearer pa_live_`), created in the dashboard. `GET /pricing`, `GET /health` and `GET /v1/version` need no key.


    Every account starts with a one-time free balance (`signup_credit_usd` in `GET /pricing`), and every paid call draws from it at its own price: `GET /v1/funding` per returned record (a no-match is free), `POST /v1/email/verify` per valid or invalid result, `POST /v1/research` per completed brief. Paid responses carry `X-Credits-Remaining`. The live price list is `GET /pricing`; a key''s balance is `GET /v1/account`. This document describes shapes, not prices.'
  version: 0.1.0
  contact:
    name: ProspectAPIs
    url: https://prospectapis.com
    email: emma@prospectapis.com
  license:
    name: Proprietary
    url: https://prospectapis.com/terms
  termsOfService: https://prospectapis.com/terms
servers:
- url: https://api.prospectapis.com
  description: Production
security:
- bearerAuth: []
tags:
- name: Account insights
  description: 'Reads about your own connected account and the people you act on: skills, profile views, social selling index and post insights.'
paths:
  /v1/people/skills:
    get:
      tags:
      - Account insights
      summary: Read a person's skills (live)
      description: A person's listed skills, each with its endorsement count and whether you endorsed it. $0.01 per read. Acts on your own connected account. Billed per call once the messaging-read family is live; while it is not yet on sale the call is free (`GET /pricing` reports `messaging_reads.available`). While `GET /pricing` does not list this route in `messaging_reads.available_routes` it answers 503 temporarily_unavailable and nothing is charged.
      operationId: readPersonSkills
      parameters:
      - name: person_ref
        in: query
        required: true
        schema:
          type: string
          maxLength: 4000
        description: The person reference from a profile or search result.
      responses:
        '200':
          description: The person's skills, read fresh, with coverage.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PeopleReadResult'
              example:
                data: {}
                coverage:
                  filled: 1
                  of: 1
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '409':
          description: No account is connected. Connect one with POST /v1/accounts/session, then retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          description: This read is temporarily unavailable. Nothing was charged.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-price-usd: 0.01
      x-agentic-access:
        action-class: connected
        consequence: read-billed
        subject: optional
        token:
          max-ttl: 3600
        audit: billing-ledger
  /v1/insights/profile-views:
    get:
      tags:
      - Account insights
      summary: Who viewed your profile (live)
      description: Who viewed your profile, where the network shows them (a hidden viewer is listed as anonymous), plus the view count. $0.01 per read. Acts on your own connected account. Billed per call once the messaging-read family is live; while it is not yet on sale the call is free (`GET /pricing` reports `messaging_reads.available`). While `GET /pricing` does not list this route in `messaging_reads.available_routes` it answers 503 temporarily_unavailable and nothing is charged.
      operationId: readProfileViews
      parameters: []
      responses:
        '200':
          description: The view count and the viewers shown, read fresh, with coverage.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PeopleReadResult'
              example:
                data: {}
                coverage:
                  filled: 1
                  of: 1
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '409':
          description: No account is connected. Connect one with POST /v1/accounts/session, then retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          description: This read is temporarily unavailable. Nothing was charged.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-price-usd: 0.01
      x-agentic-access:
        action-class: connected
        consequence: read-billed
        subject: optional
        token:
          max-ttl: 3600
        audit: billing-ledger
  /v1/insights/ssi:
    get:
      tags:
      - Account insights
      summary: Your social selling index (live)
      description: 'Your social selling index (0 to 100) and its four parts (0 to 25 each): professional_brand, finding_people, engaging_insights and building_relationships, with your top-percent rank in your industry and your network when shown. $0.01 per read. Acts on your own connected account. Billed per call once the messaging-read family is live; while it is not yet on sale the call is free (`GET /pricing` reports `messaging_reads.available`). While `GET /pricing` does not list this route in `messaging_reads.available_routes` it answers 503 temporarily_unavailable and nothing is charged.'
      operationId: readSocialSellingIndex
      parameters: []
      responses:
        '200':
          description: The index and its four parts, read fresh, with coverage.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PeopleReadResult'
              example:
                data: {}
                coverage:
                  filled: 1
                  of: 1
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '409':
          description: No account is connected. Connect one with POST /v1/accounts/session, then retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          description: This read is temporarily unavailable. Nothing was charged.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-price-usd: 0.01
      x-agentic-access:
        action-class: connected
        consequence: read-billed
        subject: optional
        token:
          max-ttl: 3600
        audit: billing-ledger
  /v1/insights/posts:
    get:
      tags:
      - Account insights
      summary: Your post insights (live)
      description: Your recent posts, each with impressions (null when not shown), reactions, comments and reposts. $0.01 per read. Acts on your own connected account. Billed per call once the messaging-read family is live; while it is not yet on sale the call is free (`GET /pricing` reports `messaging_reads.available`). While `GET /pricing` does not list this route in `messaging_reads.available_routes` it answers 503 temporarily_unavailable and nothing is charged.
      operationId: readPostInsights
      parameters:
      - name: start
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          maximum: 1000
        description: Offset into your posts, 0 to 1000.
      - name: count
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 50
        description: Posts per page, 1 to 50.
      responses:
        '200':
          description: Your posts with their counts, read fresh, with coverage.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PeopleReadResult'
              example:
                data: {}
                coverage:
                  filled: 1
                  of: 1
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '409':
          description: No account is connected. Connect one with POST /v1/accounts/session, then retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          description: This read is temporarily unavailable. Nothing was charged.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-price-usd: 0.01
      x-agentic-access:
        action-class: connected
        consequence: read-billed
        subject: optional
        token:
          max-ttl: 3600
        audit: billing-ledger
components:
  responses:
    Unauthorized:
      description: The API key is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    PaymentRequired:
      description: Out of credits. The body carries `top_up_url`; nothing was charged.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Too many requests; retry after the window.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: The request was invalid (e.g. a bad filter or input); nothing was charged.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    PeopleReadResult:
      type: object
      description: A live read's result. `data` is the person, page or result list read fresh at request time; `coverage` reports how many fields of the expected set were present on the source.
      required:
      - data
      - coverage
      properties:
        data:
          type: object
          additionalProperties: true
          description: The read result. For search, posts, engagers and followers this is `{ items, page }`; for a profile it is the profile object.
        coverage:
          type: object
          description: How complete the source was.
          properties:
            filled:
              type: integer
            of:
              type: integer
    Error:
      type: object
      required:
      - error
      description: Every error answers with this shape. `error` is a human-readable message; `code` is a stable machine code when present.
      properties:
        error:
          type: string
        code:
          type: string
          description: A stable error code, e.g. INVALID_FILTER, INVALID_INPUT, INVALID_ID, NOT_FOUND, INSUFFICIENT_CREDITS, WATCHLIST_LIMIT, RATE_LIMITED.
        message:
          type: string
          description: Extra guidance on some errors (401, 402).
        field:
          type: string
          description: The offending field, on some 400s.
        top_up_url:
          type: string
          format: uri
          description: Where to add credits, on a 402.
      additionalProperties: true
  headers:
    RateLimit-Limit:
      description: Requests this API key may make per minute.
      schema:
        type: integer
    RateLimit-Reset:
      description: Seconds until the current window resets.
      schema:
        type: integer
    RateLimit-Remaining:
      description: Requests left in the current one-minute window.
      schema:
        type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key as a bearer token: `Authorization: Bearer pa_live_<48 hex>`. Create and manage keys in the dashboard at https://prospectapis.com.'
externalDocs:
  description: API reference and quickstart
  url: https://prospectapis.com/docs