---
name: "WWW::Search::Pagesjaunes"
section: "3pm"
platform: "linux"
package: "libwww-search-perl"
version: "2.51.80-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/WWW::Search::Pagesjaunes"
---

# WWW::Search::Pagesjaunes(3pm)

Lookup phones numbers from www.pagesjaunes.fr

## NAME

WWW::Search::Pagesjaunes - Lookup phones numbers from www.pagesjaunes.fr

## SYNOPSIS

```
 use WWW::Search::Pagesjaunes;
 my $pj = new WWW::Search::Pagesjaunes;
 $pj->find( activite => "Plombier", localite => "Paris" );
 do {
    print $_->entry . "\n" foreach ($pj->results);
 } while $pj->has_more;
```

## DESCRIPTION

The WWW::Search::Pagesjaunes provides name, phone number and addresses of French telephone subscribers by using the \<http://www.pagesjaunes.fr\> directory.

## METHODS

Two classes are used in this module, a first one (WWW::Search::Pagesjaunes) to do the fetching and parsing, and the second one and a second one (WWW::Search::Pagesjaunes::Entry) holding the entry infos.

Here are the methods for the main WWW::Search::Pagesjaunes module:

- **new()**

  The constructor accept an optional LWP::UserAgent as argument, if you want to provide your own.

- find( %request )

  Here are the values for the `%request` hash that are understood. They each have two name, the first is the french one and the second is the english one:

  - nom / name

    Name of the person you're looking for.

  - activite / business

    Business type of the company you're looking for. Note that if this field is filled, the module searches in the yellow pages.

  - localite / town

    Name of the town you're searching in.

  - prenom / firstname

    First name of the person you're looking for. It is not set if you set the 'activite' field.

  - departement / district

    Name or number of the Département or Région you're searching in.

- **results()**

  Returns an array of WWW::Search::Pagesjaunes::Entry containing the first matches of the query.

- limit($max\_number\_of\_entries)

  Set the maximum number of entries returned. Default to 50.

- **has\_more()**

  If the query leads to more than a few results, the field has\_more is set. You can then call the **results()** method again to fetch the datas.

The WWW::Search::Pagesjaunes::Entry class has six methods:

- new($name, $address, $phone, $fax)

  Returns a new WWW::Search::Pagesjaunes::Entry.

- name

  Returns the name of the entry.

- address

  Returns the address of the entry.

- phone

  Returns the phone number of the entry.

- is\_fax

  Returns true if the phone number is a fax one, false otherwise. Note that currently, this method always returns 0.

- entry($separator)

  Returns the concatenation of the name and the phone number, separated by " - ". You can specify your own separator as first argument.

## BUGS

The phone numbers are sometimes not correctly parsed, esp. when one entry has several phone numbers.

If you found a bug and want to report it or send a patch, you are encouraged to use the CPAN Request Tracker interface: \<https://rt.cpan.org/NoAuth/Dists.html?Queue=WWW-Search-Pagesjaunes\>

## COPYRIGHT

Please read the Publisher information of \<http://www.pagesjaunes.fr\> available at the following URL: \<http://www.pagesjaunes.fr/pj.cgi?html=commun/avertissement.html&lang=en\>

WWW::Search::Pagesjaunes is Copyright (C) 2002, Briac Pilpré

This module is free software; you can redistribute it or modify it under the same terms as Perl itself.

## AUTHOR

Briac Pilpré \<briac@cpan.org\>