Official scripts
Explore our curated collection of scripts
Get Pappers company officer history
Fetches a French company's full officer history from Pappers by SIREN: both current and former officers/auditors, with role, tenure dates, and status. Complements pappers.fr/get_company, which only returns current officers — this is the affordance for "who held what role, and when" including people who've left. An unknown SIREN throws (Pappers' unknown-SIREN placeholder page lists unrelated companies' officers).
Pappers company profile
Fetches a company's Pappers profile from its SIREN. Returns name, siren, address, postal_code, city, head_office_siret, naf_code, naf_label, legal_form, share_capital, creation_date, workforce, status, business_sector and officers (display_name, role, since, to, former, age, is_legal_entity, siren, first_name, last_name) — both current and past officers, people and legal entities alike; a legal-entity officer carries its own 9-digit siren and no age. An unknown SIREN throws rather than returning data: Pappers answers it with a placeholder page whose officer block lists unrelated companies. Phone, website and email are not included since they are reserved for Pappers accounts; use google.com/search_places instead.
Search Pappers companies
Search French companies on Pappers by name, or look one up directly by its SIREN or SIRET. Returns each company with its legal form, main activity, head-office address, workforce bracket, share capital, creation date and status. A name search pages through up to 400 results. An identifier lookup returns the single matching company and includes its head-office SIRET, but Pappers does not provide share capital or workforce figures on that route.
Search Events (FR)
Search Ticketmaster France for events by keyword. Returns each event's starting price in EUR, venue, city, genre, and date.
Search La French Tech jobs
Search job listings on La French Tech's public careers board (la-french-tech.welcomekit.co, an embeddable careers widget aggregating openings across French Tech ecosystem startups) by free-text keyword and optional filters: department (site's own category, e.g. "Tech", "Sales", "Business" — French labels), city (e.g. "Paris", "Lyon"), and contractType (site's own French label, e.g. "CDI", "Stage", "Alternance", "CDD / Temporaire"). Filter values must match the site's own labels exactly — an unrecognized value throws rather than silently searching unfiltered. Pagination is 1-based via page; requesting a page beyond what's available throws rather than silently returning page 1. Returns total, page, totalPages, and jobs (id, reference, slug, title, url, company {name, slug, employees, logoUrl}, department, profession, contractType + contractTypeLabel, remote, salary, office, offices, publishedAt, promoted). A query/filter combination with no matches returns an empty jobs list, not an error.
Search France Travail jobs
Search France Travail (formerly Pôle Emploi) public job listings by keyword, optional free-text location (city or department), and page (20 offers/page). Returns total (page 1 only) and jobs (jobId, title, company, location, description, contract, postedAgo, url). Location free text is resolved via France Travail's own public geo API to a commune or department code (same as picking the first suggestion in the UI); an unrecognized location throws instead of silently searching nationwide. Page 1 is read directly from the results page; later pages are fetched via the site's own "load more" mechanism. total is only returned for page 1 — later pages don't repeat it.
Search restaurants near a coordinate
Search TheFork restaurants near a lat/lng, one page (site paginates 25/page). Returns pagination (totalCount/totalPage/hasNext) and per-restaurant: name, address, coords, distanceM from the input point, theforkRating (/10) plus reviews, avgPriceEur, priceRangeLevel, cuisine, promoPct (max %% discount in deals) and raw deals, url. Results come back in the site's default quality order, not by distance, so filter by distanceM caller-side and loop `page` to totalPage.
Search PAP.fr property listings
Search PAP.fr, the French classifieds site where owners list property directly without an agency, and return the listings on the results page: the listing's id and link, asking price in euros, town and postcode, number of rooms and bedrooms, floor area, and the owner's description. Give a location the way you would type it into the site's own search box — a town, postcode, department or region — and the closest match the site offers is used; the match actually applied is returned so you can check it. Buying and renting are both covered, and the property type, maximum price and how many listings to collect can each be set. Leaving the property type unset searches every type. PAP widens a town search to nearby communes and labels those results with the distance, so a search for one town can legitimately return listings in its neighbours. Land and parking listings have no rooms or floor area, which come back empty rather than as zero. When nothing matches, PAP shows a few listings from a deliberately wider search instead. Those are not results for the query, so they are never returned as if they were: the reply says plainly that there were no exact matches and the list comes back empty.
Search Station F jobs
Search job listings on Station F's public careers board (jobs.stationf.co, an embeddable careers widget aggregating openings across Station F resident startups) by free-text keyword and optional filters: department/profession (site's own category label, e.g. "Tech", "Business", "Sales", "Operations", "Comm / Marketing"), city (e.g. "Paris"), and contractType (site's own English label, e.g. "Full-Time", "Internship", "Apprenticeship", "Fixed-Term"). Filter values must match the site's own labels exactly — an unrecognized value throws rather than silently searching unfiltered. Pagination is 1-based via page; requesting a page beyond what's available throws rather than silently returning page 1. Returns total, page, totalPages, and jobs (id, reference, slug, title, url, company {name, slug, employees, logoUrl}, department, profession, contractType + contractTypeLabel, remote, salary, office, offices, publishedAt, promoted). A query/filter combination with no matches returns an empty jobs list, not an error.
Search Doctolib practitioners
Search Doctolib practitioners by specialty and location. Returns total, page, and providers with full_name, specialty, address, sector, payment_means, languages, telehealth, online_booking, matched_visit_motive, and profile_path. There are 20 providers per page and the order is server-ranked; profile_path (including ?pid=practice-N) is the join key for get_practitioner and list_slots.
Search leboncoin jobs
Search leboncoin's "Offres d'emploi" (job listings) category by free-text keyword and optional free-text city location. Reads the search page's own richer underlying data rather than the visible cards, so results include salary, contract type, sector, experience, study level, and work time when the poster provided them (fields are null otherwise, which is common for private-seller ads with no company attached). Location text is matched against leboncoin's own city list, picking the closest whole-city match; an unrecognized location throws. Pagination is 1-based, 35 results per page. An unmatched keyword returns a clean empty result rather than an error. One known limitation: requesting a page beyond the search's real page count is detected and reported as an explicit out-of-range error, rather than the misleading empty result leboncoin's own site would otherwise show.
