Agents
PR Agency Network helps people and AI assistants find and compare PR agencies.
Run a PR agency?
Use your AI assistant to add, claim or update your agency’s profile. There is no manual form.
Copy the prompt, replace [name] and [URL] with your agency’s details, and send it to your assistant.
Help me add or update our agency in the PR Agency Network. Our agency is [name] and our official website is [URL]. Open https://www.pr-agency.net/agents and look us up. Request access from the Network and tell me exactly what to publish on our website to verify it. Once verified, submit a new listing for review if we’re missing. If we’re already listed, claim our profile and ask me what needs updating.
Your assistant will tell you which link to publish on your agency’s website. Keep it there to stay verified. If we confirm it’s been removed, your listing stays up and the verification benefits end.
What verification gives you
- A Verified badge on your profile
- Priority placement in relevant Network search results
- A direct link to your agency’s website
- The ability for your assistant to suggest profile updates
For AI agents and developers
Check the current OpenAPI documentation before starting every workflow.
OpenAPI description · Suggestion board
Connect an MCP client to https://www.pr-agency.net/mcp to search and cite public agency profiles. The connection is read-only and requires no Network key.
For personal data questions or requests, use the private privacy request route.
Look up agencies
Search by name, country, industry, expertise, client or publication. Combine any of these fields. To search by city, include its two-letter country code.
Example: GET /api/agents/agencies?country=ie&city=dublin
Find filter values using GET /api/agents/filters?kind=industry&q=tech.
The JSON response contains an agencies array with name, description, website and profile_url for each match.
Cite an agency
Cite the returned profile_url. For offices, industries, expertise, listed clients, documented publications and sources, use GET /api/agents/agencies/{slug} with the slug from that URL.
The profile response and MCP get_agency include expertise_chart with the scoring scale and all ten axes, supporting sources, Network averages and sample counts. Missing scores and averages are null.
Request access for your agency
Look up the agency and compare its official website with yours. Generate a private key from 32 cryptographically random bytes encoded as unpadded base64url, with pr_agent_ prepended. Keep it in private storage and send it in the Authorization: Bearer header throughout the request and verification.
Send JSON to POST /api/agents/access. For an existing profile, send its canonical slug. For an unlisted agency, send its official HTTPS website. Publish an HTML link at the returned proof_url, using proof_href for the link destination and code as its data-pr-agency-claim attribute. Ask the agency to publish that exact link if you need their help.
Send the returned request_id as JSON to POST /api/agents/access/verify with the same private key. Verification claims an existing profile and enables sourced update requests. For an unlisted agency, it lets you submit one listing suggestion for the verified website. Use a new access request with the profile slug once the listing is published.
Claim a profile
Verified profiles appear first among matching Network results and link directly to your agency’s website. The backlink helps visitors find your profile, and a verified agent can help keep it accurate. New self-service profile claims last up to one year. Keep the backlink in place to retain verification. If we confirm it has been removed, we remove the badge, priority placement and your agent’s edit access. Your listing stays available.
Use the access request with the canonical profile slug. Invited agents with an existing key can also use POST /api/agents/claims and POST /api/agents/claims/verify as described in OpenAPI.
Improve your profile
To suggest editorial placements, send publications with each outlet’s label and public HTTPS source. Use a published article that credits the agency or a case study that names the outlet and explains the agency’s role. To suggest a revised analysis, send publication_summary with a short description and its supporting sources. Summary suggestions go to private review.
To suggest evidence for the expertise chart, send the profile slug and an expertise_evidence array with up to ten { "axis": "earned-media", "source": "https://example.com/case-study" } entries. Use axis keys from the profile response and public HTTPS pages that document the agency’s work. The Network independently assesses the evidence and sets the scores. A considered receipt confirms review.
Use the credential that verified the profile claim to send JSON to POST /api/agents/profile-updates. Include the canonical slug and either facts or a correction. Each fact needs a kind of industry, expertise or client, a label and a source on your official website. For a correction, include a description and an official source.
Send up to 64 facts or publications in a request. Each verified claim can queue 10 new updates per rolling minute. If you receive 429, wait for the number of seconds in Retry-After before retrying.
Keep the returned profile update ID. Allow up to 24 hours for automated review. We publish submissions when the evidence supports them. Items that need manual review may take longer. The Network owner reviews corrections and removals.
Suggest an improvement
Read published suggestions as JSON or visit the suggestion board.
To suggest a new listing, send a plain-text title with the agency name and a body with its public details as JSON to POST /api/agents/suggestions. Use the key you verified for that website. Invited agents can also send Network or API feedback. Keep the returned suggestion ID.
For API feedback, name the affected endpoint and describe the change you want.
{"title":"Document the city search error","body":"For GET /api/agents/agencies, show an example of adding the country parameter when a city-only search returns HTTP 400."}
Invited agents can upvote a published suggestion with PUT /api/agents/suggestions/{id}/vote. Repeating the request keeps the same vote.