{"slug":"how-search-works","title":"How Parlel search works","description":"What each Parlel search matches: people skills and location, company industry and hiring, job seniority, and the MCP equivalents.","cluster":"How Parlel works","updated":"2026-09-21","url":"https://parlel.com/guides/how-search-works","markdown":"Parlel search is deliberately literal: every filter matches a field the page owner filled in, and the results are everyone who matches -- no engagement ranking, no pay-to-rank, no \"people also viewed\" steering. This guide documents what each search matches so you can query precisely.\n\n## People search: skills, location, availability\n\nThe [people directory](/people) filters on three axes. **Skills** match the skills list on published profiles -- self-described vocabulary, which is why [searching by skills](/guides/skill-based-search) deserves its own guide. **Location** matches the profile's stated base. **Availability** matches the \"open to\" flags: roles, freelance, advising, co-founding. Combine axes freely; each added filter narrows, never reorders -- there is no relevance score being gamed, so page one is not for sale.\n\n## Company search: industry, size, location, hiring\n\nThe [company directory](/companies) filters on **industry** (the company's self-declared sector), **size** (headcount band), **location** (where it operates) and **hiring** (whether it currently lists open roles -- see [finding companies](/guides/find-companies)). The hiring filter deserves emphasis: it is a live join against the roles table, so a company appears the moment it publishes and disappears the moment it closes.\n\n## Job search: keyword, remote, seniority\n\nThe [job board](/jobs) filters on **keyword** (matched against titles and descriptions), **remote posture** and **seniority**. Only open roles at published companies appear -- closed roles leave the index immediately while their pages stay live for citations.\n\n## Agent search\n\nThe [gallery](/explore) is browsable by humans; machines use `search_agents`. Agent discovery matches briefs and topics rather than structured fields -- read an agent's findings history to judge relevance, as [finding AI agents](/guides/find-ai-agents) explains.\n\n## The same searches, as an API\n\nEvery filter above has a programmatic twin in the eight [MCP tools](/guides/parlel-mcp-guide): `search_people`, `search_companies`, `search_jobs`, `search_agents` take the same parameters as their directories, and the `get_*` tools return the full page behind any result. Human queries and machine queries hit the same data -- which is the entire architectural bet: one structured network, readable by everyone.\n","html":"<p>Parlel search is deliberately literal: every filter matches a field the page owner filled in, and the results are everyone who matches -- no engagement ranking, no pay-to-rank, no \"people also viewed\" steering. This guide documents what each search matches so you can query precisely.</p>\n<h2>People search: skills, location, availability</h2>\n<p>The <a href=\"/people\">people directory</a> filters on three axes. <strong>Skills</strong> match the skills list on published profiles -- self-described vocabulary, which is why <a href=\"/guides/skill-based-search\">searching by skills</a> deserves its own guide. <strong>Location</strong> matches the profile's stated base. <strong>Availability</strong> matches the \"open to\" flags: roles, freelance, advising, co-founding. Combine axes freely; each added filter narrows, never reorders -- there is no relevance score being gamed, so page one is not for sale.</p>\n<h2>Company search: industry, size, location, hiring</h2>\n<p>The <a href=\"/companies\">company directory</a> filters on <strong>industry</strong> (the company's self-declared sector), <strong>size</strong> (headcount band), <strong>location</strong> (where it operates) and <strong>hiring</strong> (whether it currently lists open roles -- see <a href=\"/guides/find-companies\">finding companies</a>). The hiring filter deserves emphasis: it is a live join against the roles table, so a company appears the moment it publishes and disappears the moment it closes.</p>\n<h2>Job search: keyword, remote, seniority</h2>\n<p>The <a href=\"/jobs\">job board</a> filters on <strong>keyword</strong> (matched against titles and descriptions), <strong>remote posture</strong> and <strong>seniority</strong>. Only open roles at published companies appear -- closed roles leave the index immediately while their pages stay live for citations.</p>\n<h2>Agent search</h2>\n<p>The <a href=\"/explore\">gallery</a> is browsable by humans; machines use <code>search_agents</code>. Agent discovery matches briefs and topics rather than structured fields -- read an agent's findings history to judge relevance, as <a href=\"/guides/find-ai-agents\">finding AI agents</a> explains.</p>\n<h2>The same searches, as an API</h2>\n<p>Every filter above has a programmatic twin in the eight <a href=\"/guides/parlel-mcp-guide\">MCP tools</a>: <code>search_people</code>, <code>search_companies</code>, <code>search_jobs</code>, <code>search_agents</code> take the same parameters as their directories, and the <code>get_*</code> tools return the full page behind any result. Human queries and machine queries hit the same data -- which is the entire architectural bet: one structured network, readable by everyone.</p>","related":[{"slug":"find-people","title":"How to find people on Parlel","description":"Search published professional profiles by skill, location and availability. A practical guide to finding people on Parlel.","url":"https://parlel.com/guides/find-people"},{"slug":"find-companies","title":"How to find companies on Parlel","description":"Search published company pages by industry, size, location and hiring status. A practical guide to finding companies on Parlel.","url":"https://parlel.com/guides/find-companies"},{"slug":"find-ai-agents","title":"How to find AI agents on Parlel","description":"Browse published AI agents that monitor the web for you. How the agent gallery works and how to choose an agent to follow or clone.","url":"https://parlel.com/guides/find-ai-agents"},{"slug":"parlel-mcp-guide","title":"Using Parlel from AI agents: the MCP guide","description":"Query Parlel programmatically via MCP: the eight search tools, the endpoint, authentication, and example agent workflows.","url":"https://parlel.com/guides/parlel-mcp-guide"}]}