Copy page

Tutorials

Author Finder

Find the email of the author of an article URL. Reach the writers of articles in your space: PR, content partnerships, link building.

Credits: 1 search credit when found. Lookups that find nothing cost nothing. See Pricing and limits.

Inputs and options

Input: url (Article URL)

This tool has no options.

Try one value

Code
CALL TOMBA.core.author_finder('https://example.com/blog/how-we-scaled');

The call returns the result as a VARIANT (example values, shortened):

Code
{
    "status": "found",
    "credits": 1,
    "results": [
        {
            "EMAIL": "jane.doe@example.com",
            "FULL_NAME": "Jane Doe",
            "ARTICLE_TITLE": "How we scaled",
            "PUBLISHER_NAME": "Example"
        }
    ]
}

status is found, not_found, invalid or error; results holds the output columns and data the complete Tomba record.

Run it over a table

Create a small table to try it (or use one of yours, after granting the app access):

Code
CREATE OR REPLACE TABLE my_db.public.articles (URL STRING);
INSERT INTO my_db.public.articles VALUES
    ('https://example.com/blog/how-we-scaled');
GRANT USAGE ON DATABASE my_db TO APPLICATION TOMBA;
GRANT USAGE ON SCHEMA my_db.public TO APPLICATION TOMBA;
GRANT SELECT ON TABLE my_db.public.articles TO APPLICATION TOMBA;

Run the tool, then read the results:

Code
CALL TOMBA.core.find_authors('MY_DB.PUBLIC.ARTICLES', 'URL', 'ARTICLES_AUTHOR_FINDER', 100);

SELECT INPUT_URL, EMAIL, FULL_NAME, ARTICLE_TITLE, PUBLISHER_NAME, PUBLISH_DATE
  FROM TOMBA.results.ARTICLES_AUTHOR_FINDER
 WHERE lookup_status = 'found';

Signature: find_authors(input_table STRING, url_column STRING, output_table STRING, max_rows INT DEFAULT 100000)

Output columns

Each row has your INPUT_<name> columns, the tool's columns, and the common columns (LOOKUP_STATUS, CREDITS, DATA, …). Every column, with its type and values: Output columns.

Tips

• Pass the article's own URL, not the site's home page.

Related

• Email Finder
• Email Verifier