Searching for people on LinkedIn

Use search_people to search LinkedIn's people directory. Filter by keyword, title, company, location, and industry. Each call returns up to 25 results (default 10) with a cursor for pagination, and every search counts against your daily search limit (300 by default, resetting at midnight UTC).

Sales Navigator filters

If your account has Sales Navigator, extra filters unlock automatically: seniority_level, company_headcount, function, school, years_of_experience, years_in_current_position, changed_jobs, and posted_on_linkedin. Supplying any of these auto-routes the search to Sales Navigator, no configuration needed.

You can also paste a full LinkedIn or Sales Navigator search URL into the url parameter and Crispy runs it directly. When you do, all other filters are ignored, so it's the fastest way to reuse targeting you already built in the LinkedIn UI.

Reading the results

Every result includes a crispy_context object with what Crispy already knows about the person: is_connection (a real 1st-degree connection), profile_saved, invitation_pending, invitation_accepted, viewed_your_profile, and blacklisted. You can tell at a glance who is safe to contact without extra lookups.

Common mistakes: - Passing a company name as text. A numeric company ID (from search_companies) gives exact matches, names can be fuzzy. - Paging forever. LinkedIn caps any search at roughly 1,000 results. If new results stop appearing, narrow with location or title filters instead of paging deeper. - Re-running the same search and burning your daily budget. Results are cached, add refresh: true only when you genuinely need live data.

Pro tip: results are automatically saved to your local profile library in the background, so you can recall people later with zero API calls.