Piloterr Datasets API

The Datasets API from Piloterr — 1 operation(s) for datasets.

GitHub OpenAPI

Operations 1

POST /v2/datasets/linkedin/company Dataset Linkedin Company #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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/piloterr-com:piloterr-com-datasets-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.

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

OpenAPI Specification

piloterr-com-datasets-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Piloterr API Reference Datasets API
  description: Complete API reference documentation.
  version: 1.0.0
servers:
- url: https://api.piloterr.com
  description: API Server
tags:
- name: Datasets
paths:
  /v2/datasets/linkedin/company:
    post:
      summary: Dataset Linkedin Company
      description: 'Query the LinkedIn company dataset with Elasticsearch Query DSL. Filter by name, domain, industry, headcount, and country. POST-only, 1 credit per row returned.


        **Credit cost:** 1 credit per row'
      operationId: datasets-linkedin-company
      security:
      - ApiKeyAuth: []
      parameters:
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  hits:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                        _type:
                          type: string
                        _index:
                          type: string
                        _score:
                          type: number
                        _source:
                          type: object
                          properties:
                            name:
                              type: string
                            domain:
                              type: string
                            founded:
                              type: integer
                            tagline:
                              type: string
                            website:
                              type: string
                            industry:
                              type: string
                            created_at:
                              type: string
                            updated_at:
                              type: string
                            description:
                              type: string
                            staff_count:
                              type: integer
                            staff_range:
                              type: string
                            linkedin_url:
                              type: string
                            locations_list:
                              type: array
                              items: {}
                            last_crawled_at:
                              type: string
                            headquarter_city:
                              nullable: true
                            headquarter_line1:
                              nullable: true
                            linkedin_id_alpha:
                              type: string
                            specialities_list:
                              type: array
                              items:
                                type: string
                            headquarter_country:
                              nullable: true
                            linkedin_id_numeric:
                              type: integer
                            headquarter_postal_code:
                              nullable: true
                  total:
                    type: integer
                  max_score:
                    type: number
                  search_metadata:
                    type: object
                    properties:
                      credits:
                        type: object
                        properties:
                          linkedin_company_count:
                            type: integer
                      account_id:
                        type: string
                      account_name:
                        type: string
              examples:
                Search by company name - WebAPI Group:
                  value:
                    hits:
                    - _id: '31'
                      _type: _doc
                      _index: linkedin_company
                      _score: 18.08
                      _source:
                        name: WebAPI Group
                        domain: webapi.group
                        founded: 2022
                        tagline: We elevate your business, one API at a time.
                        website: https://www.webapi.group/
                        industry: Software Development
                        created_at: '2024-05-06T08:59:44.485+00:00'
                        updated_at: '2026-01-01T14:18:57.406+00:00'
                        description: Unlock the full potential of web intelligence with our APIs.
                        staff_count: 2
                        staff_range: 1-10
                        linkedin_url: https://www.linkedin.com/company/webapi-group
                        locations_list: []
                        last_crawled_at: '2026-01-01T14:18:35.442+00:00'
                        headquarter_city: null
                        headquarter_line1: null
                        linkedin_id_alpha: webapi-group
                        specialities_list:
                        - API
                        - Scraping
                        - Web
                        - Web intelligence
                        headquarter_country: null
                        linkedin_id_numeric: 101119787
                        headquarter_postal_code: null
                    total: 1
                    max_score: 18.08
                    search_metadata:
                      credits:
                        linkedin_company_count: 1
                      account_id: '*'
                      account_name: '*'
                Lookup by domain - openai.com:
                  value:
                    hits:
                    - _id: '2842'
                      _type: _doc
                      _index: linkedin_company
                      _score: 18.084406
                      _source:
                        name: OpenAI
                        domain: openai.com
                        founded: 2015
                        tagline: Creating safe AGI that benefits all of humanity.
                        website: https://openai.com/
                        industry: Research Services
                        description: OpenAI is an AI research and deployment company.
                        staff_count: 3848
                        staff_range: 1k-5k
                        linkedin_url: https://www.linkedin.com/company/openai
                        headquarter_city: San Francisco
                        linkedin_id_alpha: openai
                        specialities_list:
                        - artificial intelligence machine learning
                        headquarter_country: US
                        linkedin_id_numeric: 11130470
                    total: 34
                    max_score: 18.084406
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Datasets
components:
  parameters:
    fields:
      name: fields
      in: query
      required: false
      description: Comma-separated list of response fields to return, with dot notation for nested fields (e.g. `name,location.city`).
      schema:
        type: string
    is_async:
      name: is_async
      in: query
      required: false
      description: 'Run the request as a background job: the API answers `202` with a `job_id` to poll on `GET /v1/jobs/{id}`.'
      schema:
        type: boolean
        default: false
    soft_fail:
      name: soft_fail
      in: query
      required: false
      description: Return HTTP 200 even when the request fails; the error is in the `error` field of the body.
      schema:
        type: boolean
        default: false
  schemas:
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          description: Human-readable error message.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your API key. Include it in the x-api-key header for every request.