{
  "openapi": "3.0.1",
  "info": {
    "title": "Trade Show Exhibitors & Attendees Finder",
    "description": "Find who exhibited at and attended a trade show: give its name, get the exhibitors with the people who publicly announced or reported being there (LinkedIn posts, comments, company news), each with evidence and a likelihood score, plus booth staff by role. Pay per company and per person.",
    "version": "0.1",
    "x-build-id": "cr5jXL4AGcGt7vXb5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/sherwood~trade-show-people-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-sherwood-trade-show-people-finder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/sherwood~trade-show-people-finder/runs": {
      "post": {
        "operationId": "runs-sync-sherwood-trade-show-people-finder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/sherwood~trade-show-people-finder/run-sync": {
      "post": {
        "operationId": "run-sync-sherwood-trade-show-people-finder",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "eventName": {
            "title": "Trade show name",
            "type": "string",
            "description": "Name of the show, ideally with the edition year (\"IMTS 2026\", \"Hannover Messe 2026\"). The Actor finds the official site, the exhibitor catalog and the dates with a Google search. Aliases: event, tradeShow, name."
          },
          "year": {
            "title": "Edition year",
            "minimum": 2000,
            "maximum": 2100,
            "type": "integer",
            "description": "Year of the edition when it is not in the name. Default: the year found in the name, else the current year."
          },
          "startDate": {
            "title": "Start date",
            "type": "string",
            "description": "First day of the show, YYYY-MM-DD. Found automatically when empty. LinkedIn posts are searched from 60 days before this date to 30 days after endDate."
          },
          "endDate": {
            "title": "End date",
            "type": "string",
            "description": "Last day of the show, YYYY-MM-DD."
          },
          "eventUrl": {
            "title": "Official website",
            "type": "string",
            "description": "Home page of the show. Found with Google when empty. Alias: url (when the URL does not look like an exhibitor list)."
          },
          "exhibitorListUrl": {
            "title": "Exhibitor list URL",
            "type": "string",
            "description": "The page listing the exhibitors (Map Your Show, Messe Frankfurt, Koelnmesse, Informa, a2z, Ungerboeck and 20+ other platforms read by Skython). Found from the site when empty. Give it when the automatic resolution fails."
          },
          "eventLinkedinUrl": {
            "title": "LinkedIn page of the show",
            "type": "string",
            "description": "https://www.linkedin.com/company/... or /showcase/... of the event. Used to find posts mentioning the show."
          },
          "hashtags": {
            "title": "Official hashtags",
            "type": "array",
            "description": "Hashtags used for the edition (#IMTS2026). Synthesized from the name when empty.",
            "items": {
              "type": "string"
            }
          },
          "companies": {
            "title": "Exhibitors you already have",
            "type": "array",
            "description": "Names, website URLs, or objects {name, website, linkedinUrl}. Added to (or instead of) the catalog. Alias: exhibitors."
          },
          "companiesDatasetId": {
            "title": "Dataset with the exhibitors",
            "type": "string",
            "description": "Dataset of an exhibitor list scraper run (Skython or another one): name, website and LinkedIn fields are detected. When this Actor runs as an integration after such a run, leave it empty: the dataset of the triggering run is used."
          },
          "targetCompanies": {
            "title": "Companies you are looking for, in plain words",
            "type": "string",
            "description": "What kind of exhibitors interest you (\"software vendors for food traceability\", \"packaging machinery makers\"). Each exhibitor is judged against it (targetFit 0 to 1) and only those at or above minTargetFit are enriched and charged. Leave empty to keep every exhibitor."
          },
          "excludeCompanies": {
            "title": "Companies to exclude",
            "type": "array",
            "description": "Names or domains to leave out (your own company, competitors).",
            "items": {
              "type": "string"
            }
          },
          "minTargetFit": {
            "title": "Minimum target fit",
            "minimum": 0,
            "maximum": 1,
            "type": "number",
            "description": "Exhibitors under this fit (0 to 1) are off target: not enriched, not charged, hidden unless includeOffTargetCompanies.",
            "default": 0.5
          },
          "includeOffTargetCompanies": {
            "title": "Include off-target companies",
            "type": "boolean",
            "description": "Also output the exhibitors under minTargetFit, without people and free of charge.",
            "default": false
          },
          "maxCompanies": {
            "title": "Max exhibitors read",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Exhibitors read from the catalog (Skython bills 0.0045 USD each and reads at least 20).",
            "default": 200
          },
          "evidenceSources": {
            "title": "Evidence sources",
            "type": "array",
            "description": "Where to look for people who were there.",
            "items": {
              "type": "string",
              "enum": [
                "posts",
                "comments",
                "websites",
                "reactions"
              ],
              "enumTitles": [
                "LinkedIn posts",
                "Comments on those posts",
                "Company websites and blogs",
                "Reactions on those posts (weak evidence, costs 0.002 USD each)"
              ]
            },
            "default": [
              "posts",
              "comments",
              "websites"
            ]
          },
          "maxPosts": {
            "title": "Max LinkedIn posts",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Posts read across all search queries (harvestapi bills 0.002 USD per post, comment or reaction).",
            "default": 300
          },
          "maxEngagementsPerPost": {
            "title": "Max comments or reactions per post",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Comments (and reactions, when enabled) read per post, 25 by default. Each one is billed 0.002 USD by harvestapi and judged as evidence.",
            "default": 25
          },
          "includeRoleBased": {
            "title": "Add booth staff by role",
            "type": "boolean",
            "description": "For each targeted exhibitor with a LinkedIn page, search its employees whose title matches roleKeywords (harvestapi: 0.02 USD per company plus 0.003 USD per profile).",
            "default": true
          },
          "roleKeywords": {
            "title": "Role keywords",
            "type": "array",
            "description": "Job title words searched for booth staff. Default: sales, business development, commercial, export, account manager, key account, marketing, communication, trade show, events, CEO, founder, co-founder, managing director, general manager, country manager, president, VP.",
            "items": {
              "type": "string"
            }
          },
          "maxPeoplePerCompany": {
            "title": "Max role-based people per company",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Employees searched by role per targeted exhibitor, 5 by default (0.003 USD each, billed by harvestapi).",
            "default": 5
          },
          "minAttendanceScore": {
            "title": "Minimum attendance score",
            "minimum": 0,
            "maximum": 1,
            "type": "number",
            "description": "People under this score (0 to 1) are not output and not charged. 0.3 keeps everyone who at least announced coming or exhibiting.",
            "default": 0.3
          },
          "maxPeople": {
            "title": "Max people",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Cap on the people delivered in the run, with evidence and by role together. 1000 by default.",
            "default": 1000
          },
          "maxSubActorSpendUsd": {
            "title": "Budget for the third-party Actors (USD)",
            "minimum": 0,
            "maximum": 10000,
            "type": "number",
            "description": "Cap on what the Actors called on your behalf may bill you in this run (Google search, Skython, harvestapi). Each call gets a share; Apify imposes at least 0.30 USD per call (0.50 for Google search).",
            "default": 10
          },
          "estimateOnly": {
            "title": "Estimate only",
            "type": "boolean",
            "description": "Stop after the estimate item: nothing is called, nothing is charged.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}