Map Extract
Tutorial · Outreach

How to find journalist requests for experts

Follow the complete setup and run process for this module. You will start with keywords, hashtags, date rules, journalist criteria and expert profiles, work through each control in order and finish with a live queue of relevant media requests and response status.

  • 10 steps
  • 11 screenshots
  • Windows desktop app
  • Status: Beta
  1. Step 1: Discover requests

    Import an X scraping project with read only access, discover profiles in the separate Commentary browser, or use existing PR data. Refresh X projects reloads projects; Choose X database selects a source. Enter search keywords, hashtags and known journalist handles one per line. Name and bio filters do not verify professional credentials.

    Discover requests: No import selected; sample keywords, hashtags journorequest and prrequest, known handles and profile phrases. X project import is read only
    Discover requests: No import selected; sample keywords, hashtags journorequest and prrequest, known handles and profile phrases. X project import is read only.
  2. Step 2: Bound discovery and resume

    Use Profile must contain at least one phrase to narrow discovery. Review Maximum journalists and Recent posts per journalist. Start and Prepare combined run are separate controls; check the intended configuration before starting.

    Request dates and filters: dates use UTC, Custom age is selected and both optional date filters are unchecked
    Request dates and filters: dates use UTC, Custom age is selected and both optional date filters are unchecked.
  3. Step 3: Set dates and request signals

    Dates use UTC. Set the maximum request age for your campaign. Old requests leave the active queue and remain in saved history. Unknown dates are never sent; eligibility is checked again immediately before email dispatch.

    Do not respond to requests older than 7 days. The summary reports requests from the last 7 days matching any of 6 signal phrases
    Do not respond to requests older than 7 days. The summary reports requests from the last 7 days matching any of 6 signal phrases.
  4. Step 4: Save factual expert profiles

    Save multiple experts with name, role or qualifications, expertise phrases and a verified biography containing actual contributions. Expertise phrases match the request. You can assign an expert manually in the queue. Choose the expert SMTP sender and reply inbox explicitly, then Save expert. New expert starts another profile.

    Expert profiles: explicit selection, name, role or qualifications, expertise phrases, verified contributions and expert Gemini instructions with request and biography macros
    Expert profiles: explicit selection, name, role or qualifications, expertise phrases, verified contributions and expert Gemini instructions with request and biography macros.
    AI commentary: instructions for every expert response, Approval mode Manual approval and Sending account mode Expert specific SMTP / inbox. An actual expert must supply and verify commentary
    AI commentary: instructions for every expert response, Approval mode Manual approval and Sending account mode Expert specific SMTP / inbox. An actual expert must supply and verify commentary.
  5. Step 5: Prepare drafting rules

    Expert Gemini instructions support request and biography macros. Global instructions apply to every response. Choose Manual approval and configure Expert specific SMTP / inbox when the expert needs a separate sender. AI drafts are example replies: the actual expert must supply and verify their contribution before use. Do not invent credentials, knowledge or personal experience.

    Outreach and warm up: Delivery mode Collect and draft only, with no posting, following, messaging or email delivery. Repeat contact protection 45 days
    Outreach and warm up: Delivery mode Collect and draft only, with no posting, following, messaging or email delivery. Repeat contact protection 45 days.
  6. Step 6: Review each response

    Every response is saved in the preview queue before sending. Search by journalist, request or expert. Assign the expert, then Generate or regenerate now. Inspect the request, recipient, subject, sender and actual expert contribution. Editing clears approval; review and approve the edited version again. Expired responses remain in History.

    Response preview queue: Active (0), with Journalist, State, Posted (UTC), Expert and Blocking reason. Every response is saved here before sending
    Response preview queue: Active (0), with Journalist, State, Posted (UTC), Expert and Blocking reason. Every response is saved here before sending.
  7. Step 7: Choose outreach mode

    Choose Collect and draft only for research and draft preparation. This mode performs no posting, following, messaging or email delivery. Approval and delivery are separate steps. A received reply stops further outreach to that journalist.

    Collect and draft only: no external outreach. Repeat contact protection 45 days; Pacing and warm up is collapsed
    Collect and draft only: no external outreach. Repeat contact protection 45 days; Pacing and warm up is collapsed.
  8. Step 8: Select the Commentary browser identity

    The Commentary browser runs independently of X scraping. Rotation waits until the entire journalist job finishes, including warm up and delivery. Project only mode creates a separate empty browser identity with separately persisted cookies. Use Open X sign in for selected mode; enter verification codes directly in the PR browser, then Start resumes.

    Browser profiles: Profile mode Selected global profile, Rotation interval 60 minutes and sign in guidance. Project only mode creates a separate empty browser identity
    Browser profiles: Profile mode Selected global profile, Rotation interval 60 minutes and sign in guidance. Project only mode creates a separate empty browser identity.
  9. Step 9: Configure Commentary SMTP

    Choose a dedicated Commentary sender or explicitly opt into shared global senders. Select a sender explicitly and use Refresh senders to reload identities. Set the sender name, From address, Reply To address, SMTP host, username, password or app password and signature. Reply To should point to the inbox you monitor. There is no automatic fallback to unrelated SMTP accounts.

    Commentary SMTP: shared global senders unchecked, Select a sender explicitly, Port 587 and STARTTLS. Provider details are empty
    Commentary SMTP: shared global senders unchecked, Select a sender explicitly, Port 587 and STARTTLS. Provider details are empty.
  10. Step 10: Monitor the reply inbox

    Select the intended inbox and configure IMAP host, username, folder, port, TLS and password or app password. Save inbox credentials, then Check journalist replies. This is a read only fetch of the latest 100 messages, displaying messages from known journalist bio addresses. It does not mark mail as read or send automatic replies.

    Commentary reply inbox: INBOX, Port 993, SSL and a read only fetch of the latest 100 messages. No automatic replies
    Commentary reply inbox: INBOX, Port 993, SSL and a read only fetch of the latest 100 messages. No automatic replies.

Check the result

Relevant media requests and prepared expert responses with original request links.

  • Requests are read from the X module, which needs a signed-in X session.
  • Filters match names and bios; they do not verify credentials.
  • AI helps with wording but cannot supply an expert's real contribution.

Read the responsible use guidance and the anti-spam policy before you run this module on real data.

Troubleshooting

The expected input or account is missing
Recheck the prerequisites: Project; X module with a signed-in session; Expert evidence; SMTP only for approved email delivery.
The output is incomplete or unavailable
Request collection does not promise media coverage or a response.
The job was interrupted
Pause or stop the supported local job controls, then inspect its recorded state. Resolve a blocked account or source before restarting. Check the destination before repeating any action whose outcome is uncertain.

Questions

What setup does the Journalist Request Tool require?

X journalist requests, date and phrase filters, and expert profiles. Project. X module with a signed-in session. Expert evidence. SMTP only for approved email delivery.

What does Journalist Request Tool produce?

Relevant media requests and prepared expert responses with original request links.

How does date filtering work?

Dates use UTC. Set optional from and through dates to narrow the research period. Old requests remain in history; unknown dates are never sent. Eligibility is checked again before dispatch.

How does expert matching work?

Expertise phrases match the actual request. You can manually assign an expert in the queue. Save factual credentials, verified biography and actual contributions; Gemini instructions can reference those details through macros.

What happens after a draft is created?

Every response is saved before sending. Review the request, expert, recipient and sender, then add and verify the actual expert contribution. Editing clears approval. Approval does not itself enable delivery.

How are browser, email and replies handled?

The independent Commentary browser finishes the entire journalist job before rotation. SMTP sender selection is explicit. The reply inbox reads the latest 100 messages without marking mail read or sending automatic replies. A received reply stops further outreach to that journalist.

Next steps

Follow along in the free demo

Install Map Extract on Windows and work through these steps with a small test project.

Top